DXGKARG_DESCRIBEALLOCATION - NtDoc

Native API online documentation, based on the System Informer (formerly Process Hacker) phnt headers
// d3dkmddi.h

typedef struct _DXGKARG_DESCRIBEALLOCATION {
  [in]  HANDLE                       hAllocation;
  [out] UINT                         Width;
  [out] UINT                         Height;
  [out] D3DDDIFORMAT                 Format;
  [out] D3DDDI_MULTISAMPLINGMETHOD   MultisampleMethod;
  [out] D3DDDI_RATIONAL              RefreshRate;
  [out] UINT                         PrivateDriverFormatAttribute;
  [out] DXGK_DESCRIBEALLOCATIONFLAGS Flags;
  [out] D3DDDI_ROTATION              Rotation;
} DXGKARG_DESCRIBEALLOCATION;
View the official Windows Driver Kit DDI reference

NtDoc

No description available.

Windows Driver Kit DDI reference (ns-d3dkmddi-_dxgkarg_describeallocation)

_DXGKARG_DESCRIBEALLOCATION structure

Description

The DXGKARG_DESCRIBEALLOCATION structure describes an existing allocation.

Members

hAllocation [in]

A handle to an allocation that information is requested for. The driver previously returned this handle in the hAllocation member of the DXGK_ALLOCATIONINFO structure from a call to the driver's DxgkDdiCreateAllocation function.

Width [out]

The width of the allocation, in pixels. The driver returns the width value.

Height [out]

The height of the allocation, in pixels. The driver returns the height value.

Format [out]

A D3DDDIFORMAT-typed value that indicates the pixel format of the allocation. The driver returns the format value.

MultisampleMethod [out]

A D3DDDI_MULTISAMPLINGMETHOD structure that describes the multiple-sampling method that is used for the allocation. The driver returns the description.

RefreshRate [out]

A D3DDDI_RATIONAL structure that indicates the refresh rate that the primary surface was created with, if applicable.

PrivateDriverFormatAttribute [out]

A UINT value that specifies a private format attribute for the allocation. The driver specifies surface format attributes (for example, the pixel layout of a tiled surface) that it otherwise cannot expose to the operating system.

The operating system uses the information in PrivateDriverFormatAttribute to compare two surfaces. For example, an A8R8B8G8 800x600 surface and an X8R8B8G8 800x600 surface should have the same information in PrivateDriverFormatAttribute if they have the same format attributes, which includes pixel layout.

Flags [out]

This member is reserved.

Supported starting with Windows 8.

Rotation [out]

This member is reserved.

Supported starting with Windows 8.

See also

D3DDDIFORMAT

D3DDDI_MULTISAMPLINGMETHOD

D3DDDI_RATIONAL

D3DDDI_ROTATION

DXGK_ALLOCATIONINFO

DXGK_DESCRIBEALLOCATIONFLAGS

DxgkDdiCreateAllocation

DxgkDdiDescribeAllocation