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) |