Edit

D3DDDICB_ESCAPE structure (d3dumddi.h)

  • Article

The D3DDDICB_ESCAPE structure describes information that a user-mode display driver shares with a display miniport driver.

Syntax

typedef struct _D3DDDICB_ESCAPE {
  [in]     HANDLE             hDevice;
  [in]     D3DDDI_ESCAPEFLAGS Flags;
  [in/out] VOID               *pPrivateDriverData;
  [in]     UINT               PrivateDriverDataSize;
  [in]     HANDLE             hContext;
} D3DDDICB_ESCAPE;

Members

[in] hDevice

A handle to the display device (graphics context) that was originally passed to the user-mode display driver's CreateDevice or CreateDevice(D3D10) function or NULL, if the shared information is not associated with a display device.

[in] Flags

A D3DDDI_ESCAPEFLAGS structure that indicates, in bit-field flags, how to share information. The user-mode display driver 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 is allocated by the user-mode display driver that contains information that the user-mode display driver sends to the display miniport driver or that the user-mode display driver receives from the display miniport driver.

[in] PrivateDriverDataSize

The size, in bytes, of the buffer that pPrivateDriverData points to.

[in] hContext

A handle to the context that the pfnCreateContextCb function returned or NULL, if the shared information is not associated with a context. If the user-mode display driver sets hContext to a non-NULL value, the driver must have also set hDevice to a non-NULL value, and hDevice must correspond to the device that owns the context.

Requirements

Requirement Value
Minimum supported client Available in Windows Vista and later versions of the Windows operating systems.
Header d3dumddi.h (include D3dumddi.h)

See also

CreateDevice

CreateDevice(D3D10)

pfnCreateContextCb

pfnEscapeCb