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

See also

D3DDDIFORMAT

D3DKMDT_GDISURFACETYPE

DxgkDdiGetStandardAllocationDriverData

DxgkDdiPresent