D3DDDICB_QUERYRESIDENCY struttura (d3dumddi.h)

La struttura D3DDDICB_QUERYRESIDENCY descrive lo stato di residenza di una risorsa o un elenco di allocazioni.

Sintassi

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

Members

[in] hResource

Handle a una risorsa la cui residenza viene eseguita una query. Se il driver di visualizzazione in modalità utente usa la matrice nel membro HandleList per eseguire una query per la residenza, imposta hResource su NULL.

Se hResource non è NULL, tutte le allocazioni appartenenti alla risorsa vengono eseguite query e il risultato viene restituito nel primo elemento della matrice a cui pResidencyStatus punta. Lo stato di residenza di una risorsa è uguale allo stato di residenza più basso di tutte le allocazioni che appartengono alla risorsa.

[in] NumAllocations

Numero di allocazioni nella matrice HandleList . Se il driver di visualizzazione in modalità utente imposta l'handle nel membro hResource su non NULL, deve impostare NumAllocations su zero.

[in] HandleList

Matrice di tipi di dati D3DKMT_HANDLE che rappresentano handle in modalità kernel alle allocazioni. La funzione pfnAllocateCb del runtime di Microsoft Direct3D restituisce questi handle. Pertanto, il driver di visualizzazione in modalità utente usa questi handle per eseguire query per la residenza.

Se il driver di visualizzazione in modalità utente imposta l'handle nel membro hResource su non NULL, deve impostare HandleList su NULL.

[out] pResidencyStatus

Puntatore a una matrice di valori D3DDDI_RESIDENCYSTATUS. Se il membro hResource non è NULL, la matrice contiene un singolo elemento e riceve uno dei valori seguenti per indicare lo stato di residenza della risorsa. Se hResource è NULL, il numero di elementi nella matrice viene specificato dal membro NumAllocations e ogni elemento riceve uno dei valori seguenti per indicare lo stato di residenza dell'allocazione corrispondente nella matrice specificata da HandleList.

Valore Significato
D3DDDI_RESIDENCYSTATUS_RESIDENTINGPUMEMORY (1) La risorsa o l'elenco di allocazioni risiedono nella memoria GPU, ovvero lo stato di residenza più alto.
D3DDDI_RESIDENCYSTATUS_RESIDENTINSHAREDMEMORY (2) La risorsa o l'elenco di allocazioni risiedono nella memoria condivisa.
D3DDDI_RESIDENCYSTATUS_NOTRESIDENT (3) La risorsa o l'elenco di allocazioni non è rientro, ovvero lo stato di residenza più basso.

Requisiti

Requisito Valore
Client minimo supportato Disponibile in Windows Vista e versioni successive dei sistemi operativi Windows.
Intestazione d3dumddi.h (include D3dumddi.h)

Vedi anche

pfnQueryResidencyCb