D3DDDIARG_CREATERESOURCE 結構 (d3dukmdt.h)
D3DDDIARG_CREATERESOURCE 結構包含建立資源的資訊。
語法
typedef struct _D3DDDIARG_CREATERESOURCE {
[in] D3DDDIFORMAT Format;
[in] D3DDDI_POOL Pool;
[in] D3DDDIMULTISAMPLE_TYPE MultisampleType;
[in] UINT MultisampleQuality;
[in] const D3DDDI_SURFACEINFO *pSurfList;
[in] UINT SurfCount;
[in] UINT MipLevels;
[in] UINT Fvf;
[in] D3DDDI_VIDEO_PRESENT_SOURCE_ID VidPnSourceId;
[in] D3DDDI_RATIONAL RefreshRate;
[in/out] HANDLE hResource;
[in] D3DDDI_RESOURCEFLAGS Flags;
[in] D3DDDI_ROTATION Rotation;
} D3DDDIARG_CREATERESOURCE;
成員
[in] Format
指出資源格式 的D3DDDIFORMAT型別值。
[in] Pool
D3DDDI_POOL型別值,指出資源建立來源的記憶體集區類型。
[in] MultisampleType
D3DDDIMULTISAMPLE_TYPE型別值,指出多重取樣表面的樣本數目。 如果表面不是多重取樣,這個值會D3DDDIMULTISAMPLE_NONE (0) 。
[in] MultisampleQuality
在多重取樣表面中轉譯樣本的質量等級。 品質等級必須是 0 到 7 的數位,分別代表 1 到 8 的質量等級。
請注意,即使表面不是多重取樣 (亦即,如果在 MultisampleType 中指定D3DDDIMULTISAMPLE_NONE) 它仍然可以有大於 1 (品質等級,而該層級是使用大於 0) 的數位來指定。
[in] pSurfList
要建立之介面清單 (或其他資源類型的 D3DDDI_SURFACEINFO 結構陣列) 。
[in] SurfCount
陣列中 pSurfList 成員所指定的資源數目。
[in] MipLevels
資源的 MIP 對應層級數目。
[in] Fvf
頂點緩衝區的 FVF 格式。
[in] VidPnSourceId
如果資源包含主要表面) ,則影片呈現來源在視訊呈現網路路徑中的以零起始的標識碼, (VidPN) 拓撲 (上建立主要表面。
[in] RefreshRate
D3DDDI_RATIONAL結構,指定資源所使用的重新整理速率。 只有當資源是主要介面,而且未在 Flags 成員中設定 MatchGdiPrimary 位字段旗標時,才適用這個成員。 此外,如果在 Flags 中設定 InterlacedRefresh 位欄位旗標,則使用者模式顯示驅動程式會判斷重新整理速率交錯 (否則漸進式) 。
[in/out] hResource
資源的句柄。 在 CreateResource 函式的輸入上, hResource 會指定驅動程式在回呼至 Microsoft Direct3D 運行時間時應該使用的句柄。
驅動程式會產生唯一的句柄,並將它傳回 Direct3D 運行時間。 在 CreateResource 函式的輸出上, hResource 會指定 Direct3D 執行時間在後續驅動程式呼叫中應該用來識別資源的句柄。
[in] Flags
識別要建立之資源類型的 D3DDDI_RESOURCEFLAGS 結構。 請注意, D3DDDI_RESOURCEFLAGS 中的某些位字段旗標也需要設定額外的位字段旗標。
[in] Rotation
識別資源方向 的D3DDDI_ROTATION型別值。
例如,假設使用者模式顯示器驅動程式收到 480x640 表面旋轉 90 度的要求, (D3DDDI_ROTATION_90) 。 驅動程式應該以 640x480 模式配置表面以供掃描之用。 轉譯至表面時,驅動程式應該執行 90 度旋轉。
只有在 [旗標] 成員中同時設定 [主要位字段旗標] 時,才會設定D3DDDI_ROTATION_IDENTITY以外的方向。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | 可在 Windows Vista 和更新版本的 Windows 作業系統中使用。 |
標頭 | d3dukmdt.h (包含 D3dumddi.h、D3dkmddi.h) |