D3DKMTSetAllocationPriority - NtDoc
Native API online documentation, based on the System Informer
(formerly Process Hacker) phnt
headers
// d3dkmthk.h
NTSTATUS D3DKMTSetAllocationPriority(
[in] const D3DKMT_SETALLOCATIONPRIORITY *unnamedParam1
);
View the official Windows Driver Kit DDI referenceNo description available.
The D3DKMTSetAllocationPriority function sets the priority level of a resource or list of allocations.
unnamedParam1 [in]A pointer to a D3DKMT_SETALLOCATIONPRIORITY structure that contains information for setting the priority level of a resource or list of allocations.
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.
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);
}