D3DKMDT_GDISURFACEDATA structure

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

Syntax


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

Members

Width

[in] The width of the surface, in pixels.

Height

[in] The height of the surface, in pixels.

Format

[in] 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.

Type

[in] A D3DKMDT_GDISURFACETYPE-typed value that indicates the surface type.

Flags

[in] Reserved for future use. Must be zero.

Pitch

[out] 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

Version

Supported starting with Windows 7.

Header

D3dkmdt.h (include D3dkmdt.h)

See also

D3DDDIFORMAT
D3DKMDT_GDISURFACETYPE
DxgkDdiGetStandardAllocationDriverData
DxgkDdiPresent

 

 

Send comments about this topic to Microsoft

Show: