D3DKMTSetAllocationPriority function (d3dkmthk.h)
The D3DKMTSetAllocationPriority function sets the priority level of a resource or list of allocations.
Syntax
NTSTATUS D3DKMTSetAllocationPriority(
[in] const D3DKMT_SETALLOCATIONPRIORITY *unnamedParam1
);
Parameters
[in] unnamedParam1
A pointer to a D3DKMT_SETALLOCATIONPRIORITY structure that contains information for setting the priority level of a resource or list of allocations.
Return value
D3DKMTSetAllocationPriority returns one of the following values:
| Return code | Description |
|---|---|
| STATUS_SUCCESS | Priority level for allocations was successfully set. |
| STATUS_DEVICE_REMOVED | The graphics adapter was stopped or the display device was reset. |
| STATUS_INVALID_PARAMETER | Parameters were validated and determined to be incorrect. |
This function might also return other NTSTATUS values.
Remarks
The following code example demonstrates how an OpenGL ICD can use D3DKMTSetAllocationPriority to set the priority level of a resource (and therefore all of the allocations that are associated with the resource).
VOID SetResourcePriority(D3DKMT_HANDLE hDevice, D3DKMT_HANDLE hResource, UINT uiPriority)
{
D3DKMT_SETALLOCATIONPRIORITY SetAllocationPriorityData;
SetAllocationPriorityData.hDevice = hDevice;
SetAllocationPriorityData.hResource = hResource;
SetAllocationPriorityData.phAllocationList = NULL;
SetAllocationPriorityData.AllocationCount = 0;
SetAllocationPriorityData.Priorities = &uiPriority;
(*pfnKTSetAllocationPriority)(&SetAllocationPriorityData);
}
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows Vista |
| Target Platform | Universal |
| Header | d3dkmthk.h (include D3dkmthk.h) |
| Library | Gdi32.lib |
| DLL | Gdi32.dll |