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) |