Expand Minimize

CreateRenderTargetView routine

The CreateRenderTargetView function creates a render target view.

Syntax


PFND3D10DDI_CREATERENDERTARGETVIEW CreateRenderTargetView;

VOID APIENTRY CreateRenderTargetView(
  _In_  D3D10DDI_HDEVICE hDevice,
  _In_  const D3D10DDIARG_CREATERENDERTARGETVIEW *pCreateRenderTargetView,
  _In_  D3D10DDI_HRENDERTARGETVIEW hRenderTargetView,
  _In_  D3D10DDI_HRTRENDERTARGETVIEW hRTRenderTargetView
)
{ ... }

Parameters

hDevice [in]

A handle to the display device (graphics context).

pCreateRenderTargetView [in]

A pointer to a D3D10DDIARG_CREATERENDERTARGETVIEW structure that describes the parameters that the user-mode display driver uses to create a render target view.

hRenderTargetView [in]

A handle to the driver's private data for the render target view. The driver returns the size, in bytes, of the memory region that the Microsoft Direct3D runtime must allocate for the private data from a call to the driver's CalcPrivateRenderTargetViewSize function. The handle is really just a pointer to a region of memory, the size of which the driver requested. The driver uses this region of memory to store internal data structures that are related to its render target view object.

hRTRenderTargetView [in]

A handle to the render target view that the driver should use anytime it calls back into the Direct3D runtime.

Return value

None

The driver can use the pfnSetErrorCb callback function to set an error code. For more information about setting error codes, see the following Remarks section.

Remarks

The driver might run out of memory. Therefore, the driver can pass E_OUTOFMEMORY or D3DDDIERR_DEVICEREMOVED in a call to the pfnSetErrorCb function. The Direct3D runtime will determine that any other errors are critical. If the driver passes any errors, including D3DDDIERR_DEVICEREMOVED, the Direct3D runtime will determine that the handle is invalid; therefore, the runtime will not call the DestroyRenderTargetView function to destroy the handle that the hRenderTargetView parameter specifies.

Requirements

Version

Available in Windows Vista and later versions of the Windows operating systems.

Header

D3d10umddi.h (include D3d10umddi.h)

See also

CalcPrivateRenderTargetViewSize
D3D10DDI_DEVICEFUNCS
D3D10DDIARG_CREATERENDERTARGETVIEW
DestroyRenderTargetView
pfnSetErrorCb

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft