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 参考页的“备注”部分。

要求

要求
最低受支持的客户端 在 Windows Vista 和更高版本的 Windows 操作系统中可用。
标头 d3dumddi.h (包括 D3dumddi.h)

另请参阅

pfnAllocateCb

pfnSetPriorityCb