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) |