Fonction D3DKMTSetAllocationPriority (d3dkmthk.h)

La fonction D3DKMTSetAllocationPriority définit le niveau de priorité d’une ressource ou d’une liste d’allocations.

Syntaxe

NTSTATUS D3DKMTSetAllocationPriority(
  [in] const D3DKMT_SETALLOCATIONPRIORITY *unnamedParam1
);

Paramètres

[in] unnamedParam1

Un pointeur vers une structure de D3DKMT_SETALLOCATIONPRIORITY qui contient des informations pour définir le niveau de priorité d’une ressource ou une liste d’allocations.

Valeur retournée

D3DKMTSetAllocationPriority retourne l’une des valeurs suivantes :

Code de retour Description
STATUS_SUCCESS Le niveau de priorité pour les allocations a été correctement défini.
STATUS_DEVICE_REMOVED La carte graphique a été arrêtée ou le périphérique d’affichage a été réinitialisé.
STATUS_INVALID_PARAMETER Les paramètres ont été validés et déterminés comme incorrects.

Cette fonction peut également retourner d’autres valeurs NTSTATUS .

Remarques

L’exemple de code suivant montre comment un ICD OpenGL peut utiliser D3DKMTSetAllocationPriority pour définir le niveau de priorité d’une ressource (et donc toutes les allocations associées à la ressource).

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);
}

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows Vista
Plateforme cible Universal
En-tête d3dkmthk.h (inclure D3dkmthk.h)
Bibliothèque Gdi32.lib
DLL Gdi32.dll

Voir aussi

D3DKMT_SETALLOCATIONPRIORITY