Expand Minimize

DxgkDdiEscape routine

The DxgkDdiEscape function shares information with the user-mode display driver.

Syntax


PDXGKDDI_ESCAPE DxgkDdiEscape;

NTSTATUS APIENTRY DxgkDdiEscape(
  _In_  const HANDLE hAdapter,
  _In_  const DXGKARG_ESCAPE *pEscape
)
{ ... }

Parameters

hAdapter [in]

[in] A handle to a context block that is associated with a display adapter. The display miniport driver previously provided this handle to the Microsoft DirectX graphics kernel subsystem in the MiniportDeviceContext output parameter of the DxgkDdiAddDevice function.

pEscape [in]

[in] A pointer to a DXGKARG_ESCAPE structure that contains information about the shared information.

Return value

DxgkDdiEscape returns one of the following values:

Return codeDescription
STATUS_SUCCESS

DxgkDdiEscape successfully shared information.

STATUS_INVALID_PARAMETER

Parameters that were passed to DxgkDdiEscape contained errors that prevented it from completing.

STATUS_NO_MEMORY

DxgkDdiEscape could not allocate memory that was required for it to complete.

STATUS_PRIVILEGED_INSTRUCTION

DxgkDdiEscape detected nonprivileged instructions (that is, instructions that access memory beyond the privilege of the current central processing unit [CPU] process).

STATUS_ILLEGAL_INSTRUCTION

DxgkDdiEscape detected instructions that graphics hardware could not support.

STATUS_GRAPHICS_DRIVER_MISMATCH

The display miniport driver is not compatible with the user-mode display driver that initiated the call to DxgkDdiEscape.

 

Remarks

The DirectX graphics kernel subsystem calls the display miniport driver's DxgkDdiEscape function whenever the user-mode display driver must share information with the display miniport driver in a way that is not supported through other driver communications.

DxgkDdiEscape should be made pageable.

Requirements

Version

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

Header

D3dkmddi.h (include D3dkmddi.h)

IRQL

PASSIVE_LEVEL

See also

DXGKARG_ESCAPE
DxgkDdiAddDevice
pfnEscapeCb

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft