DD_GETFORMATDATA结构(d3dhal.h)

DirectX 8.0 及更高版本。

DD_GETFORMATDATA是具有类型D3DGDI2_TYPE_GETFORMAT的 DD_GETDRIVERINFODATA DD_GETDRIVERINFO2DATA查询 lpvData 字段指向的数据结构。

语法

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

成员

gdi2

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

dwFormatIndex

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

format

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

言论

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

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

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

要求

要求 价值
标头 d3dhal.h (包括 D3dhal.h)

另请参阅

DDPIXELFORMAT

DD_GETDRIVERINFO2DATA

DD_GETDRIVERINFODATA