Condividi tramite

struttura D3DKMT_QUERYALLOCATIONRESIDENCY (d3dkmthk.h)

  • Articolo

La struttura D3DKMT_QUERYALLOCATIONRESIDENCY descrive le informazioni per il recupero dello stato di residenza da una risorsa o da un elenco di allocazioni.

Sintassi

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;

Membri

[in] hDevice

Tipo di dati D3DKMT_HANDLE che rappresenta un handle in modalità kernel per il dispositivo a cui sono associate la risorsa o l'elenco di allocazioni.

[in] hResource

Handle per una risorsa di cui viene eseguita una query sulla residenza. Se la progettazione immagine e configurazione OpenGL usa la matrice che phAllocationList specifica di eseguire una query per la residenza, imposta hResource su NULL. Se La progettazione immagine e configurazione openGL imposta hResource su un valore NULL non, deve impostare il membro AllocationCount su zero e phAllocationList su NULL.

Se hResource non èNULL, vengono eseguite query su tutte le allocazioni appartenenti alla risorsa e il risultato viene restituito nel primo elemento della matrice a cui pResidencyStatus.

Se un'allocazione appartenente alla risorsa non è residente, l'intera risorsa viene considerata non residente.

Per recuperare informazioni dettagliate sulla residenza di ogni allocazione appartenente a una risorsa, è necessario eseguire query sull'allocazione.

[in] phAllocationList

Matrice di D3DKMT_HANDLE tipi di dati che rappresentano handle in modalità kernel per le allocazioni. La progettazione immagine e configurazione OpenGL usa questi handle per eseguire query sullo stato di residenza.

Se openGL ICD imposta l'handle nel membro hResource su un valore NULL non, deve impostare phAllocationList su NULL.

[in] AllocationCount

Numero di allocazioni nella matrice che phAllocationList. Se la progettazione immagine e configurazione openGL imposta l'handle nel membro hResource su un valore NULL non, deve impostare AllocationCount su zero.

[out] pResidencyStatus

Puntatore a una matrice di enumeratori D3DKMT_ALLOCATIONRESIDENCYSTATUS. Se il membro hResource non èNULL, la matrice contiene un singolo elemento e riceve uno degli enumeratori elencati nella tabella seguente per indicare lo stato di residenza della risorsa. Se hResource è NULL, il numero di elementi nella matrice viene specificato dal membro AllocationCount e ogni elemento riceve uno degli enumeratori seguenti per indicare lo stato di residenza dell'allocazione corrispondente nella matrice phAllocationList.

Enumeratore Significato
D3DKMT_ALLOCATIONRESIDENCYSTATUS_RESIDENTINGPUMEMORY (1) La risorsa o l'allocazione risiede nella memoria GPU.
D3DKMT_ALLOCATIONRESIDENCYSTATUS_RESIDENTINSHAREDMEMORY (2) La risorsa o l'allocazione si trova nella memoria condivisa.
D3DKMT_ALLOCATIONRESIDENCYSTATUS_NOTRESIDENT (3) La risorsa o l'allocazione non è rientrata.

Fabbisogno

Requisito Valore
client minimo supportato Windows Vista
intestazione d3dkmthk.h (include D3dkmthk.h)

Vedere anche

D3DKMTQueryAllocationResidency