struttura D3DDDICB_QUERYRESIDENCY (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;
Membri
[in] hResource
Handle per una risorsa di cui viene eseguita una query sulla residenza. 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, vengono eseguite query su tutte le allocazioni appartenenti alla risorsa e il risultato viene restituito nel primo elemento della matrice a cui pResidencyStatus. 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 nonNULL, deve impostare NumAllocations su zero.
[in] HandleList
Matrice di D3DKMT_HANDLE tipi di dati che rappresentano handle in modalità kernel per le 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 suNULL non, 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. |
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Disponibile in Windows Vista e versioni successive dei sistemi operativi Windows. |
| intestazione | d3dumddi.h (include D3dumddi.h) |