D3DKMTSetAllocationPriority function

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

Syntax

NTSTATUS D3DKMTSetAllocationPriority(
  const D3DKMT_SETALLOCATIONPRIORITY *Arg1
);

Parameters

Arg1

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

   
Minimum supported client 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