D3DKMT_ESCAPE structure (d3dkmthk.h)

The D3DKMT_ESCAPE structure describes information that is exchanged with the display miniport driver.

Syntax

typedef struct _D3DKMT_ESCAPE {
  [in]     D3DKMT_HANDLE      hAdapter;
  [in]     D3DKMT_HANDLE      hDevice;
  [in]     D3DKMT_ESCAPETYPE  Type;
  [in]     D3DDDI_ESCAPEFLAGS Flags;
  [in/out] VOID               *pPrivateDriverData;
  [in]     UINT               PrivateDriverDataSize;
  [in]     D3DKMT_HANDLE      hContext;
} D3DKMT_ESCAPE;

Members

[in] hAdapter

A handle to the graphics adapter that information is exchanged on.

[in] hDevice

A handle to a display device that is optionally specified if the information to be exchanged is specific to a particular device.

[in] Type

A value of type D3DKMT_ESCAPETYPE that indicates either to exchange information with the display miniport driver or to control kernel-mode components. The following table shows the possible values.

[in] Flags

A D3DDDI_ESCAPEFLAGS structure that indicates, in bit-field flags, how to share information. The OpenGL ICD should specify the HardwareAccess bit-field flag to indicate that the display miniport driver must access graphics hardware in such a way that the operating system must perform the second level of synchronization into the display miniport driver for the DxgkDdiEscape call.

[in/out] pPrivateDriverData

A pointer to a buffer that the OpenGL ICD allocates that contains information that the OpenGL ICD either exchanges with the display miniport driver or uses to control kernel-mode components. The following table describes the content of the buffer that pPrivateDriverData points to, depending on the value of Type.

[in] PrivateDriverDataSize

The size, in bytes, of the buffer that pPrivateDriverData points to. The OpenGL ICD must specify the size of the buffer when it calls the D3DKMTEscape function.

[in] hContext

A handle to a context that is optionally specified if the information to be exchanged is specific to a particular device context. If the OpenGL ICD sets hContext to a non-NULL value, the ICD must have also set hDevice to a non-NULL value, and hDevice must correspond to the device that owns the context.

Remarks

For testing purposes, the OpenGL ICD can pass a pointer to a D3DKMT_ESCAPE structure in a call to the D3DKMTEscape function to control the video memory manager and GPU scheduler (which are part of Dxgkrnl.sys) and the behavior of the operating system's TDR process.

Requirements

See also

D3DKMTEscape

D3DKMT_DEBUG_SNAPSHOT_ESCAPE

D3DKMT_DEVICE_ESCAPE

D3DKMT_DMM_ESCAPE

D3DKMT_TDRDBGCTRLTYPE

D3DKMT_VIDMM_ESCAPE

D3DKMT_VIDSCH_ESCAPE