structure D3DDDICB_QUERYRESIDENCY (d3dumddi.h)

  • Article

La structure D3DDDICB_QUERYRESIDENCY décrit la status de résidence d’une ressource ou une liste d’allocations.

Syntaxe

typedef struct _D3DDDICB_QUERYRESIDENCY {
  [in]  HANDLE                 hResource;
  [in]  UINT                   NumAllocations;
  [in]  const D3DKMT_HANDLE    *HandleList;
  [out] D3DDDI_RESIDENCYSTATUS *pResidencyStatus;
} D3DDDICB_QUERYRESIDENCY;

Membres

[in] hResource

Handle d’une ressource dont la résidence est interrogée. Si le pilote d’affichage en mode utilisateur utilise le tableau dans le membre HandleList pour interroger la résidence, il définit hResource sur NULL.

Si hResource n’a pas la valeur NULL, toutes les allocations qui appartiennent à la ressource sont interrogées et le résultat est retourné dans le premier élément du tableau vers lequel pointe pResidencyStatus . Le status de résidence d’une ressource est égal à la status de résidence la plus basse de toutes les allocations qui appartiennent à la ressource.

[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 non NULL, il doit définir NumAllocations sur zéro.

[in] HandleList

Tableau de D3DKMT_HANDLE types de données qui représentent les handles en mode noyau aux 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 interroger la résidence.

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

[out] pResidencyStatus

Pointeur vers un tableau de valeurs D3DDDI_RESIDENCYSTATUS. Si le membre hResource n’est pas NULL, le tableau contient un seul élément et reçoit l’une des valeurs suivantes pour indiquer la résidence status de la ressource. Si hResource a la valeur NULL, le nombre d’éléments dans le tableau est spécifié par le membre NumAllocations et chaque élément reçoit l’une des valeurs suivantes pour indiquer la résidence status de l’allocation correspondante dans le tableau spécifié par HandleList.

Valeur Signification
D3DDDI_RESIDENCYSTATUS_RESIDENTINGPUMEMORY (1) La ressource ou la liste des allocations réside dans la mémoire GPU, qui est la status de résidence la plus élevée.
D3DDDI_RESIDENCYSTATUS_RESIDENTINSHAREDMEMORY (2) La ressource ou la liste des allocations réside dans la mémoire partagée.
D3DDDI_RESIDENCYSTATUS_NOTRESIDENT (3) La ressource ou la liste d’allocations est non-résidente, ce qui est la status de résidence la plus faible.

Configuration requise

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

Voir aussi

pfnQueryResidencyCb