PFND3DDDI_ESCAPECB callback function (d3dumddi.h)
The pfnEscapeCb callback function shares information with the display miniport driver.
Syntax
PFND3DDDI_ESCAPECB Pfnd3dddiEscapecb;
HRESULT Pfnd3dddiEscapecb(
HANDLE hAdapter,
const D3DDDICB_ESCAPE *unnamedParam2
)
{...}
Parameters
hAdapter
A handle to the graphics adapter object.
unnamedParam2
pData [in, out]
A pointer to a D3DDDICB_ESCAPE structure that describes the shared information.
Return value
pfnEscapeCb returns one of the following values:
Return code | Description |
---|---|
S_OK | Information was successfully shared. |
E_OUTOFMEMORY | pfnEscapeCb could not complete because of insufficient memory. |
E_INVALIDARG | Parameters were validated and determined to be incorrect. |
D3DDDIERR_DEVICEREMOVED | pfnEscapeCb could not initiate a call to the display miniport driver's DxgkDdiEscape function because a Plug and Play (PnP) stop or a Timeout Detection and Recovery (TDR) event occurred. The user-mode display driver function that called pfnEscapeCb must return this error code back to the Direct3D runtime. Direct3D Version 9 Note: For more information about returning error codes, see Returning Error Codes Received from Runtime Functions. Direct3D Versions 10 and 11 Note: If the driver function does not return a value (that is, has VOID for a return parameter type), the driver function calls the pfnSetErrorCb function to send an error code back to the runtime. For more information about handling error codes, see Handling Errors. |
This function might also return other HRESULT values.
Remarks
A user-mode display driver calls pfnEscapeCb to share miscellaneous information with the display miniport driver in a way that is not supported by any other driver communication. The user-mode display driver can send miscellaneous information to the display miniport driver or can retrieve information from the display miniport driver.
Direct3D Version 11 Note: For more information about how the driver calls pfnEscapeCb, see Changes from Direct3D 10.
Requirements
Requirement | Value |
---|---|
Minimum supported client | Available in Windows Vista and later versions of the Windows operating systems. |
Target Platform | Desktop |
Header | d3dumddi.h (include D3dumddi.h) |