DD_GETFORMATDATA 结构 (d3dhal.h)

  • 项目

仅限 DirectX 8.0 及更高版本。

DD_GETFORMATDATA是DD_GETDRIVERINFODATA的 lpvData 字段指向的数据结构，用于类型为 D3DGDI2_TYPE_GETFORMAT 的DD_GETDRIVERINFO2DATA查询。

语法

typedef struct _DD_GETFORMATDATA {
  DD_GETDRIVERINFO2DATA gdi2;
  DWORD                 dwFormatIndex;
  DDPIXELFORMAT         format;
} DD_GETFORMATDATA;

成员

gdi2

指定包含 GetDriverInfo2 数据的DD_GETDRIVERINFO2DATA结构。

dwFormatIndex

指定要返回的像素格式的索引。

format

接收 DDPIXELFORMAT 结构中的实际像素格式。

注解

运行时使用整数索引标识要返回的格式，该索引的值变化介于 0 到 1 之间，比驱动程序前面报告的受支持格式数少一个。 这些索引如何映射到实际格式留给驱动程序。 但是，每个索引必须唯一映射到一种受支持的格式。 报告格式的顺序并不重要。

处理此 GetDriverInfo2 请求时，驱动程序应读取 dwFormatIndex 并将其映射到受支持的格式之一 (可能通过使用 dwFormatIndex 作为索引进入 DDPIXELFORMAT 结构的数组) ，然后将该格式复制到DD_GETFORMATDATA字段的格式字段中。 运行时保证它仅将索引传递给驱动程序，该索引的范围比驱动程序报告的图面格式数少 0 到 1。 应在调试驱动程序生成中验证索引的范围。

仅限 DirectX 9.0 及更高版本。输入时，应用程序正在使用的 DirectX 运行时版本以格式在 DDPIXELFORMAT 结构的 dwSize 成员中指定。 此 dwSize 成员设置为 DD_RUNTIME_VERSION，这是 DirectX 9.0 0x00000900。

要求

要求 值
Header d3dhal.h (包括 D3dhal.h)

另请参阅

DDPIXELFORMAT

DD_GETDRIVERINFO2DATA

DD_GETDRIVERINFODATA