Edit

D3DKMT_SETALLOCATIONPRIORITY structure (d3dkmthk.h)

  • Article

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

Syntax

typedef struct _D3DKMT_SETALLOCATIONPRIORITY {
  [in] D3DKMT_HANDLE       hDevice;
  [in] D3DKMT_HANDLE       hResource;
  [in] const D3DKMT_HANDLE *phAllocationList;
  [in] UINT                AllocationCount;
  [in] const UINT          *pPriorities;
} D3DKMT_SETALLOCATIONPRIORITY;

Members

[in] hDevice

A D3DKMT_HANDLE data type that represents a kernel-mode handle to the device that the resource or list of allocations are associated with.

[in] hResource

A handle to a resource whose priority must be set. If the OpenGL ICD uses the array that phAllocationList specifies to set the priority for the list of allocations, it sets hResource to NULL. If the OpenGL ICD sets hResource to a non-NULL value, it must set the AllocationCount member to zero and phAllocationList 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] phAllocationList

An array of D3DKMT_HANDLE data types that represent kernel-mode handles to the allocations. If the OpenGL ICD sets the handle in the hResource member to a non-NULL value, it must set phAllocationList to NULL.

[in] AllocationCount

The number of allocations in the array that phAllocationList specifies. If the OpenGL ICD sets the handle in the hResource member to a non-NULL value, it must set AllocationCount to zero.

[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 AllocationCount member, and each allocation in the array that phAllocationList specifies is set to the priority level of the corresponding element in pPriorities.

Each element in pPriorities can be set to one of the following values.

Enumerator Meaning
D3DDDI_ALLOCATIONPRIORITY_MINIMUM (0x28000000) Minimum priority
D3DDDI_ALLOCATIONPRIORITY_LOW (0x50000000) Low priority
D3DDDI_ALLOCATIONPRIORITY_NORMAL (0x78000000) Normal priority
D3DDDI_ALLOCATIONPRIORITY_HIGH (0xa0000000) High priority
D3DDDI_ALLOCATIONPRIORITY_MAXIMUM (0xc8000000) Maximum priority

For more information about the meanings of the preceding values, see the Remarks section of the pfnSetPriorityCb function.

Requirements

Requirement Value
Minimum supported client Windows Vista
Header d3dkmthk.h (include D3dkmthk.h)

See also

D3DKMTSetAllocationPriority