Create Method (WindowRenderTarget)

In This Topic

Creates an WindowRenderTarget, a render target that renders to a window.

Syntax

Visual Basic
C#

'Declaration
 
Public Shared Function Create( _
   ByVal factory As Factory, _
   ByVal renderTargetProperties As RenderTargetProperties, _
   ByVal hwndProperties As HwndRenderTargetProperties _
) As WindowRenderTarget

public static WindowRenderTarget Create( 
   Factory factory,
   RenderTargetProperties renderTargetProperties,
   HwndRenderTargetProperties hwndProperties
)

Parameters

factory: an instance of Factory
renderTargetProperties: The rendering mode, pixel format, remoting options, DPI information, and the minimum DirectX support required for hardware rendering. For information about supported pixel formats, see {{Supported Pixel Formats and Alpha Modes}}.
hwndProperties: The window handle, initial size (in pixels), and present options.

Remarks

When you create a render target and hardware acceleration is available, you allocate resources on the computer's GPU. By creating a render target once and retaining it as long as possible, you gain performance benefits. Your application should create render targets once and hold onto them for the life of the application or until the {{D2DERR_RECREATE_TARGET}} error is received. When you receive this error, you need to recreate the render target (and any resources it created).

Reference

WindowRenderTarget Class
WindowRenderTarget Members