D3DDDICB_SETPRIORITY structure (d3dumddi.h)

The D3DDDICB_SETPRIORITY structure describes the priority level to which to set a resource or list of allocations.

Syntax

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

Members

[in] hResource

A handle to a resource whose priority must be set. If the user-mode display driver uses the array that is specified by HandleList to set the priority for the list of allocations, it sets hResource to NULL. If the user-mode display driver sets hResource to a non-NULL value, it must set the NumAllocations member to zero and HandleList to NULL.

If hResource is non-NULL, all of the allocations that belong to the resource are set to the priority that is specified by the first element in the array that pPriorities points to.

[in] NumAllocations

The number of allocations in the HandleList array. If the user-mode display driver sets the handle in the hResource member to a non-NULL value, it must set NumAllocations to zero.

[in] HandleList

An array of D3DKMT_HANDLE data types that represent kernel-mode handles to the allocations. The Microsoft Direct3D runtime's pfnAllocateCb function returns these handles. Therefore, the user-mode display driver uses these handles to set priority for the allocations.

If the user-mode display driver sets the handle in the hResource member to a non-NULL value, it must set HandleList to NULL.

[in] pPriorities

A pointer to an array of priority levels. If the hResource member is non-NULL, the array must contain a single element. If hResource is NULL, the number of elements in the array is specified by the NumAllocations member, and each allocation in the array that is specified by HandleList is set to the priority level of the corresponding element in pPriorities. For a list of defined priority levels, see the Remarks section of the pfnSetPriorityCb reference page.

Requirements

Requirement	Value
Minimum supported client	Available in Windows Vista and later versions of the Windows operating systems.
Header	d3dumddi.h (include D3dumddi.h)

See also

pfnAllocateCb

pfnSetPriorityCb