DD_GETFORMATDATA結構 (d3dhal.h)

  • 發行項

僅限 DirectX 8.0 和更新版本。

DD_GETFORMATDATA是 DD_GETDRIVERINFODATA DD_GETDRIVERINFO2DATA類型為D3DGDI2_TYPE_GETFORMAT之查詢的 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