Развернуть Свернуть

D3DKMTEscape function

The D3DKMTEscape function exchanges information with the display miniport driver.

Syntax


NTSTATUS D3DKMTEscape(
  _In_  const D3DKMT_ESCAPE *pData
);

Parameters

pData [in]

A pointer to a D3DKMT_ESCAPE structure that describes the exchanged information.

Return value

D3DKMTEscape returns one of the following values:

Return codeDescription
STATUS_SUCCESS

Information was successfully shared.

STATUS_DEVICE_REMOVED

The graphics adapter was stopped or the display device was reset.

STATUS_INVALID_PARAMETER

Parameters were validated and determined to be incorrect.

STATUS_NO_MEMORY

D3DKMTEscape could not complete because of insufficient memory.

STATUS_PRIVILEGED_INSTRUCTION

D3DKMTEscape detected nonprivileged instructions (that is, instructions that access memory beyond the privilege of the current CPU process).

STATUS_ILLEGAL_INSTRUCTION

D3DKMTEscape detected instructions that cannot be supported by graphics hardware.

 

This function might also return other NTSTATUS values.

Remarks

The OpenGL ICD calls D3DKMTEscape to exchange data directly with the display miniport driver. For testing purposes, the OpenGL ICD can also call D3DKMTEscape to control the video memory manager and graphics processing unit (GPU) scheduler (which are part of Dxgkrnl.sys) and the behavior of the operating system's Timeout Detection and Recovery (TDR) process.

Hardware vendors can use D3DKMTEscape in their OpenGL ICDs as an extension mechanism. However, vendors should report necessary extensions to Microsoft so the extensions can be natively supported by the operating system.

Requirements

Version

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

Header

D3dkmthk.h (include D3dkmthk.h)

Library

Gdi32.lib

See also

D3DKMT_ESCAPE

 

 

Send comments about this topic to Microsoft

Показ:
© 2014 Microsoft