D3DKMDT_GDISURFACEDATA structure (d3dkmdt.h)

The D3DKMDT_GDISURFACEDATA structure describes surfaces that are used by GDI hardware acceleration and the Desktop Window Manager (DWM).

Syntax

typedef struct _D3DKMDT_GDISURFACEDATA {
  [in]  UINT                    Width;
  [in]  UINT                    Height;
  [in]  D3DDDIFORMAT            Format;
  [in]  D3DKMDT_GDISURFACETYPE  Type;
  [in]  D3DKMDT_GDISURFACEFLAGS Flags;
  [out] UINT                    Pitch;
} D3DKMDT_GDISURFACEDATA;

Members

[in] Width

The width of the surface, in pixels.

[in] Height

The height of the surface, in pixels.

[in] Format

A D3DDDIFORMAT-typed value that indicates the pixel format of the surface. The following formats are supported:

D3DDDIFMT_A8B8G8R8

D3DDDIFMT_X8B8G8R8

D3DDDIFMT_A8R8G8B8

D3DDDIFMT_X8R8G8B8

D3DDDIFMT_A8

The D3DDDIFMT_A8 format is used only for D3DKMDT_GDISURFACE_STAGING and D3DKMDT_GDISURFACE_STAGING_CPUVISIBLE staging surface types from the D3DKMDT_GDISURFACETYPE enumeration.

[in] Type

A D3DKMDT_GDISURFACETYPE-typed value that indicates the surface type.

[in] Flags

Reserved for future use. Must be zero.

[out] Pitch

The width of the surface, which includes padding, in bytes. The display miniport driver must return the pitch value for all allocations of D3DKMDT_GDISURFACETYPE type D3DKMDT_GDISURFACE_STAGING_CPUVISIBLE, D3DKMDT_GDISURFACE_EXISTINGSYSMEM, and D3DKMDT_GDISURFACE_TEXTURE_CROSSADAPTER.

Remarks

The D3DKMDT_GDISURFACEDATA structure is passed by the Microsoft DirectX graphics kernel subsystem in a call to the display miniport driver's DxgkDdiGetStandardAllocationDriverData function. This call generates a description of a surface that can be used for redirection by GDI hardware acceleration and the DWM.

Requirements

Requirement Value
Minimum supported client Supported starting with Windows 7.
Header d3dkmdt.h

See also

D3DDDIFORMAT

D3DKMDT_GDISURFACETYPE

DxgkDdiGetStandardAllocationDriverData

DxgkDdiPresent