共用方式為


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)

另請參閱

CreateResource

D3DDDIFORMAT

D3DDDIMULTISAMPLE_TYPE

D3DDDI_POOL

D3DDDI_RATIONAL

D3DDDI_ROTATION

D3DDDI_SURFACEINFO