DXGKARG_DESCRIBEALLOCATION 结构 (d3dkmddi.h)

项目
02/23/2024

DXGKARG_DESCRIBEALLOCATION 结构描述现有分配。

语法

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;

成员

[in] hAllocation

请求其信息的分配的句柄。驱动程序之前通过调用驱动程序的 DxgkDdiCreateAllocation 函数，在 DXGK_ALLOCATIONINFO 结构的 hAllocation 成员中返回此句柄。

[out] Width

分配的宽度（以像素为单位）。驱动程序返回宽度值。

[out] Height

分配的高度（以像素为单位）。驱动程序返回高度值。

[out] Format

一个D3DDDIFORMAT类型的值，指示分配的像素格式。驱动程序返回格式值。

[out] MultisampleMethod

描述用于分配的多重采样方法的 D3DDDI_MULTISAMPLINGMETHOD 结构。驱动程序返回说明。

[out] RefreshRate

D3DDDI_RATIONAL结构，指示创建主图面时使用的刷新率（如果适用）。

[out] PrivateDriverFormatAttribute

一个 UINT 值，该值指定分配的专用格式属性。驱动程序指定图面格式属性 (例如，平铺图面的像素布局) 否则无法向操作系统公开。

操作系统使用 PrivateDriverFormatAttribute 中的信息来比较两个图面。例如，如果A8R8B8G8 800x600 图面和X8R8B8G8 800x600 图面具有相同的格式属性（包括像素布局），则 PrivateDriverFormatAttribute 中应具有相同的信息。

[out] Flags

此成员是保留的。

从 Windows 8 开始支持。

[out] Rotation

此成员是保留的。

从 Windows 8 开始支持。