DD_GETD3DQUERYDATA 結構 (d3dhal.h)

發行項
02/23/2024

僅限 DirectX 9.0 和更新版本。

DD_GETD3DQUERYDATA是DD_GETDRIVERINFODATA的 lpvData 欄位所指向的數據結構，用於具有類型D3DGDI2_TYPE_GETD3DQUERY的DD_GETDRIVERINFO2DATA查詢。

語法

typedef struct _DD_GETD3DQUERYDATA {
  DD_GETDRIVERINFO2DATA gdi2;
  union {
    DWORD        dwQueryIndex;
    D3DQUERYTYPE QueryType;
  };
} DD_GETD3DQUERYDATA;

成員

gdi2

指定包含 GetDriverInfo2 資料的DD_GETDRIVERINFO2DATA結構。

dwQueryIndex

指定要傳回之查詢類型的索引。

QueryType

從指定實際查詢功能的 D3DQUERYTYPE 列舉中接收值。

備註

運行時間會識別要以整數索引傳回的查詢類型，其值會介於零和一個之間，小於驅動程式在D3DGDI2_TYPE_GETD3DQUERYCOUNT查詢中稍早所報告的受支持查詢類型數目。這些索引如何對應至實際的查詢類型，會保留給驅動程式。不過，每個索引都必須唯一對應至一個支持的查詢類型。報告查詢類型的順序並不重要。

處理此 GetDriverInfo2 時，驅動程式應該讀取等位中的值，就像 是 dwQueryIndex 成員一樣，並將該值對應至其中一個支持的查詢類型， (使用 dwQueryIndex 中的值做為索引，以D3DQUERYTYPE值陣列) 。然後，驅動程式應該將該查詢類型複製到等位，就像是 QueryType 成員一樣。運行時間保證它只會將索引傳遞至位於零到一個小於驅動程式所報告的查詢類型數目的驅動程式。偵錯驅動程式組建中應該驗證索引的範圍。

如需D3DQUERYTYPE的詳細資訊，請參閱 DirectX SDK 檔。