D3DDDIDEVINFO_VCACHE 結構 (d3dumddi.h)

發行項
02/25/2024

D3DDDIDEVINFO_VCACHE結構描述裝置的頂點快取資訊。

語法

typedef struct _D3DDDIDEVINFO_VCACHE {
  [out] UINT Pattern;
  [out] UINT OptMethod;
  [out] UINT CacheSize;
  [out] UINT MagicNumber;
} D3DDDIDEVINFO_VCACHE;

成員

[out] Pattern

位模式。驅動程式必須將位模式指定為 CACH 四個字元代碼， (FOURCC) 值。驅動程式可以使用下列 MAKEFOURCC 宏，將 FOURCC 值指定為 CACH：

MAKEFOURCC('C', 'A', 'C', 'H');

[out] OptMethod

網格優化的方法。驅動程式可以使用下列其中一個值來指定它所使用的網格優化。

ReplTest1	意義
D3DXMESHOPT_STRIPREORDER (0)	最長等量優化
D3DXMESHOPT_VCACHE (1)	頂點快取型優化

[out] CacheSize

驅動程式優化頂點快取的有效大小，以專案為單位。實際的快取大小不需要是 CacheSize 中指定的大小，因為大部分情況下實際快取大小較大。只有在驅動程式也指定 OptMethod 成員中的D3DXMESHOPT_VCACHE時，驅動程式才會在 CacheSize 中指定優化的大小。

[out] MagicNumber

判斷何時重新啟動等量清單時，應該做為試用版和錯誤程式的一部分使用的數位。這個數位可以從 1 到 CacheSize 成員中指定的值。一般而言，最佳值接近 CacheSize/2。只有在驅動程式也指定 OptMethod 成員中的D3DXMESHOPT_VCACHE時，驅動程式才會在 MagicNumber 中指定數位。

備註

Direct3D 運行時間 9.0 版和更新版本。 Microsoft Direct3D 運行時間會呼叫驅動程式的 CreateQuery 函式，以建立頂點快取查詢的驅動程式端資源。在此 CreateQuery 呼叫中，運行時間會在 D3DDDIARG_CREATEQUERY 結構的 QueryType 成員中指定 D3DDDIQUERYTYPE_VCACHE 查詢類型。驅動程式應該配置D3DDDIDEVINFO_VCACHE結構。運行時間接著會呼叫驅動程式的 IssueQuery 函式來處理頂點快取查詢。驅動程式應該在 GPU) 指令 (插入圖形處理器，以將頂點快取數據寫入配置。若要從驅動程式擷取頂點快取資訊，運行時間會呼叫驅動程式的 GetQueryData 函式。在此 GetQueryData 呼叫中，驅動程式應該鎖定配置，並在 pData 參數指向之 D3DDDIARG_GETQUERYDATA 結構的 pData 成員上傳回頂點快取數據。

僅限 Direct3D 運行時間 8.1 版。 Direct3D 執行時間會呼叫驅動程式的 GetInfo 函式，以從驅動程式取得頂點快取資訊。在此 GetInfo 呼叫中，運行時間會在 DevInfoID 參數中傳遞D3DDDIDEVINFOID_VCACHE旗標。驅動程式會在D3DDDIDEVINFO_VCACHE結構中指定頂點快取資訊，並在 pDevInfoStruct 參數傳回它。