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