CheckDeferredContextHandleSizes

CheckDeferredContextHandleSizes routine

The CheckDeferredContextHandleSizes function verifies the sizes of the driver-private memory spaces that hold the handle data of deferred context handles.

Syntax


PFND3D11DDI_CHECKDEFERREDCONTEXTHANDLESIZES CheckDeferredContextHandleSizes;

VOID APIENTRY CheckDeferredContextHandleSizes(
  _In_      D3D10DDI_HDEVICE    hDevice,
  _Inout_   UINT                *pHSizes,
  _Out_opt_ D3D11DDI_HANDLESIZE *pHandleSize
)
{ ... }

Parameters

hDevice [in]

A handle to the display device (graphics context).

pHSizes [in, out]

The size, in bytes, of the array pointed to by pHandleSize.

pHandleSize [out, optional]

An array of D3D11DDI_HANDLESIZE structures that describe the handle data of deferred context handles.

Return value

None

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

Remarks

The driver is only required to implement CheckDeferredContextHandleSizes if the driver supports the D3D11DDICAPS_COMMANDLISTS_BUILD_2 capability that can be returned in the D3D11DDI_THREADING_CAPS structure from a call to the GetCaps(D3D10_2) function.

For more information about how CheckDeferredContextHandleSizes is used, see Using Context-Local DDI Handles.

The driver's CheckDeferredContextHandleSizes function cannot call the pfnSetErrorCb callback function to set the D3DDDIERR_DEVICEREMOVED error code because CheckDeferredContextHandleSizes is a capability-check type of function. The driver must ensure that it has enough information after device creation to respond to a call to CheckDeferredContextHandleSizes, even in the presence of D3DDDIERR_DEVICEREMOVED.

CheckDeferredContextHandleSizes should not encounter any errors. However, CheckDeferredContextHandleSizes might call pfnSetErrorCb for critical errors.

Requirements

Target platform

Desktop

Version

CheckDeferredContextHandleSizes is supported beginning with the Windows 7 operating system.

Header

D3d10umddi.h (include D3d10umddi.h)

See also

CheckDeferredContextHandleSizes
D3D11DDI_DEVICEFUNCS
D3D11DDI_THREADING_CAPS
GetCaps(D3D10_2)
pfnSetErrorCb

 

 

Send comments about this topic to Microsoft

Show:
© 2016 Microsoft