D3DKMTSetAllocationPriority function

The D3DKMTSetAllocationPriority function sets the priority level of a resource or list of allocations.

Syntax

NTSTATUS D3DKMTSetAllocationPriority(
  CONST *D3DKMT_SETALLOCATIONPRIORITY
);

Parameters

D3DKMT_SETALLOCATIONPRIORITY

TBD

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

   
Windows version Available in Windows Vista and later versions of the Windows operating systems.
Target Platform Universal
Header d3dkmthk.h (include D3dkmthk.h)
Library Gdi32.lib
DLL Gdi32.dll

See Also

D3DKMT_SETALLOCATIONPRIORITY