Partager via

structure D3DKMT_QUERYALLOCATIONRESIDENCY (d3dkmthk.h)

  • Article

La structure D3DKMT_QUERYALLOCATIONRESIDENCY décrit les informations permettant de récupérer l’état de résidence à partir d’une ressource ou d’une liste d’allocations.

Syntaxe

typedef struct _D3DKMT_QUERYALLOCATIONRESIDENCY {
  [in]  D3DKMT_HANDLE                    hDevice;
  [in]  D3DKMT_HANDLE                    hResource;
  [in]  const D3DKMT_HANDLE              *phAllocationList;
  [in]  UINT                             AllocationCount;
  [out] D3DKMT_ALLOCATIONRESIDENCYSTATUS *pResidencyStatus;
} D3DKMT_QUERYALLOCATIONRESIDENCY;

Membres

[in] hDevice

Type de données D3DKMT_HANDLE qui représente un handle en mode noyau sur l’appareil auquel la ressource ou la liste d’allocations sont associées.

[in] hResource

Handle vers une ressource dont la résidence est interrogée. Si l’ICD OpenGL utilise le tableau qui phAllocationList spécifie d’interroger la résidence, il définit hResource sur NULL. Si l’ICD OpenGL définit hResource sur une valeur NULL non, elle doit définir le membre AllocationCount sur zéro et phAllocationList sur NULL.

Si hResource n’est pasNULL, 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 pResidencyStatus pointe.

Si une allocation qui appartient à la ressource n’est pas résidente, la ressource entière est considérée comme non résidente.

Pour récupérer des informations détaillées sur chaque allocation appartenant à une ressource, l’allocation doit être interrogée.

[in] phAllocationList

Tableau de types de données D3DKMT_HANDLE qui représentent des handles en mode noyau aux allocations. OpenGL ICD utilise ces handles pour interroger l’état de résidence.

Si l’ICD OpenGL définit le handle dans le membre hResource sur une valeur NULL non, il doit définir phAllocationList sur NULL.

[in] AllocationCount

Nombre d’allocations dans le tableau qui phAllocationList spécifie. Si l’ICD OpenGL définit le handle dans le membre hResource sur une valeur NULL non, elle doit définir AllocationCount sur zéro.

[out] pResidencyStatus

Pointeur vers un tableau d’énumérateurs D3DKMT_ALLOCATIONRESIDENCYSTATUS. Si le membre hResource n’est pasNULL, le tableau contient un élément unique et reçoit l’un des énumérateurs répertoriés dans le tableau suivant pour indiquer l’état de résidence de la ressource. Si hResource est NULL, le nombre d’éléments du tableau est spécifié par le membre AllocationCount, et chaque élément reçoit l’un des énumérateurs suivants pour indiquer l’état de résidence de l’allocation correspondante dans le tableau phAllocationList.

Recenseur Signification
D3DKMT_ALLOCATIONRESIDENCYSTATUS_RESIDENTINGPUMEMORY (1) La ressource ou l’allocation réside dans la mémoire GPU.
D3DKMT_ALLOCATIONRESIDENCYSTATUS_RESIDENTINSHAREDMEMORY (2) La ressource ou l’allocation réside dans la mémoire partagée.
D3DKMT_ALLOCATIONRESIDENCYSTATUS_NOTRESIDENT (3) La ressource ou l’allocation n’est pas l’identité.

Exigences

Exigence Valeur
client minimum pris en charge Windows Vista
d’en-tête d3dkmthk.h (include D3dkmthk.h)

Voir aussi

D3DKMTQueryAllocationResidency