D3DDDICB_SETPRIORITY structure (d3dumddi.h)

  • Article

La structure D3DDDICB_SETPRIORITY décrit le niveau de priorité auquel définir une ressource ou une liste d’allocations.

Syntaxe

typedef struct _D3DDDICB_SETPRIORITY {
  [in] HANDLE              hResource;
  [in] UINT                NumAllocations;
  [in] const D3DKMT_HANDLE *HandleList;
  [in] const UINT          *pPriorities;
} D3DDDICB_SETPRIORITY;

Membres

[in] hResource

Handle d’une ressource dont la priorité doit être définie. Si le pilote d’affichage en mode utilisateur utilise le tableau spécifié par HandleList pour définir la priorité de la liste des allocations, il définit hResource sur NULL. Si le pilote d’affichage en mode utilisateur définit hResource sur une valeur non NULL , il doit définir le membre NumAllocations sur zéro et HandleList sur NULL.

Si hResource n’a pas la valeur NULL, toutes les allocations qui appartiennent à la ressource sont définies sur la priorité spécifiée par le premier élément du tableau vers lequel pPriorities pointe.

[in] NumAllocations

Nombre d’allocations dans le tableau HandleList . Si le pilote d’affichage en mode utilisateur définit le handle dans le membre hResource sur une valeur non NULL , il doit définir NumAllocations sur zéro.

[in] HandleList

Tableau de types de données D3DKMT_HANDLE qui représentent des handles en mode noyau pour les allocations. La fonction pfnAllocateCb du runtime Microsoft Direct3D retourne ces handles. Par conséquent, le pilote d’affichage en mode utilisateur utilise ces handles pour définir la priorité des allocations.

Si le pilote d’affichage en mode utilisateur définit le handle dans le membre hResource sur une valeur non NULL , il doit définir HandleList sur NULL.

[in] pPriorities

Pointeur vers un tableau de niveaux de priorité. Si le membre hResource n’est pas NULL, le tableau doit contenir un seul élément. Si hResource a la valeur NULL, le nombre d’éléments dans le tableau est spécifié par le membre NumAllocations , et chaque allocation dans le tableau spécifiée par HandleList est définie sur le niveau de priorité de l’élément correspondant dans pPriorities. Pour obtenir la liste des niveaux de priorité définis, consultez la section Remarques de la page de référence pfnSetPriorityCb .

Configuration requise

Condition requise Valeur
Client minimal pris en charge Disponible dans Windows Vista et versions ultérieures des systèmes d’exploitation Windows.
En-tête d3dumddi.h (inclure D3dumddi.h)

Voir aussi

pfnAllocateCb

pfnSetPriorityCb