Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
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 |