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，则数组必须包含单个元素。 如果 hResourceNULL，则数组中的元素数由 NumAllocations 成员指定，并且由 HandleList 指定的数组中的每个分配都设置为 pPriorities中相应元素的优先级级别。 有关定义的优先级列表，请参阅 pfnSetPriorityCb 参考页的“备注”部分。

要求

另请参阅

pfnAllocateCb

pfnSetPriorityCb