D3DDDICB_SETPRIORITY 結構 (d3dumddi.h)

  • 發行項

D3DDDICB_SETPRIORITY 結構描述要設定資源或配置清單的優先順序層級。

語法

typedef struct _D3DDDICB_SETPRIORITY {
  [in] HANDLE              hResource;
  [in] UINT                NumAllocations;
  [in] const D3DKMT_HANDLE *HandleList;
  [in] const UINT          *pPriorities;
} D3DDDICB_SETPRIORITY;

成員

[in] hResource

必須設定其優先順序的資源句柄。 如果使用者模式顯示驅動程式使用 HandleList 所指定的數位來設定設定清單的優先順序，則會將 hResource 設定為 NULL。 如果使用者模式顯示驅動程式將 hResource 設定為非 NULL 值，則必須將 NumAllocations 成員設定為零， 而 HandleList 設定為 NULL。

如果 hResource 不是 NULL，則屬於資源的所有配置都會設定為 pPriorities 所指向陣列中第一個元素所指定的優先順序。

[in] NumAllocations

HandleList 陣列中的配置數目。 如果使用者模式顯示驅動程式將 hResource 成員中的句柄設定為非 NULL 值，則必須將 NumAllocations 設定為零。

[in] HandleList

D3DKMT_HANDLE數據類型的陣列，表示配置的核心模式句柄。 Microsoft Direct3D 運行時間的 pfnAllocateCb 函式會傳回這些句柄。 因此，使用者模式顯示驅動程式會使用這些句柄來設定配置的優先順序。

如果使用者模式顯示驅動程式將 hResource 成員中的句柄設定為非 NULL 值，則必須將 HandleList 設定為 NULL。

[in] pPriorities

優先順序層級陣列的指標。 如果 hResource 成員不是 NULL，陣列必須包含單一元素。 如果 hResource 是 NULL，陣列中的元素數目是由 NumAllocations 成員指定，而 HandleList 所指定的陣列中的每個配置都會設定為 pPriorities 中對應元素的優先順序層級。 如需已定義優先順序層級的清單，請參閱 pfnSetPriorityCb 參考頁面的一節。

規格需求

需求 值
最低支援的用戶端 可在 Windows Vista 和更新版本的 Windows 作業系統中使用。
標頭 d3dumddi.h (include D3dumddi.h)

另請參閱

pfnAllocateCb

pfnSetPriorityCb