D3DDDICB_QUERYRESIDENCY Struktur (d3dumddi.h)
Die D3DDDICB_QUERYRESIDENCY Struktur beschreibt den Residency-Status einer Ressource oder Liste der Zuordnungen.
Syntax
typedef struct _D3DDDICB_QUERYRESIDENCY {
[in] HANDLE hResource;
[in] UINT NumAllocations;
[in] const D3DKMT_HANDLE *HandleList;
[out] D3DDDI_RESIDENCYSTATUS *pResidencyStatus;
} D3DDDICB_QUERYRESIDENCY;
Angehörige
[in] hResource
Ein Handle für eine Ressource, deren Residency abgefragt wird. Wenn der Anzeigetreiber für den Benutzermodus das Array im HandleList Member zum Abfragen der Residency verwendet, legt er hResource- auf NULL-fest.
Wenn hResource- nichtNULL-ist, werden alle Zuordnungen, die zur Ressource gehören, abgefragt, und das Ergebnis wird im ersten Element des Arrays zurückgegeben, auf das pResidencyStatus verweist. Der Residency-Status einer Ressource entspricht dem niedrigsten Residency-Status aller Zuordnungen, die zur Ressource gehören.
[in] NumAllocations
Die Anzahl der Zuordnungen im HandleList- Array. Wenn der Anzeigetreiber für den Benutzermodus den Handle im hResource Member auf nicht-NULL-festlegt, muss er NumAllocations auf Null festlegen.
[in] HandleList
Ein Array von D3DKMT_HANDLE Datentypen, die Kernelmodushandles für die Zuordnungen darstellen. Die pfnAllocateCb--Funktion der Microsoft Direct3D-Laufzeit gibt diese Handles zurück. Daher verwendet der Anzeigetreiber für den Benutzermodus diese Handles, um die Residency abzufragen.
Wenn der Anzeigetreiber für den Benutzermodus den Handle im hResource Member auf nicht-NULL-festlegt, muss er HandleList- auf NULL-festlegen.
[out] pResidencyStatus
Ein Zeiger auf ein Array mit D3DDDI_RESIDENCYSTATUS Werten. Wenn das hResource Mitglied nichtNULL-ist, enthält das Array ein einzelnes Element und erhält einen der folgenden Werte, um den Residency-Status der Ressource anzugeben. Wenn hResource-NULL-ist, wird die Anzahl der Elemente im Array durch das NumAllocations-Element angegeben, und jedes Element erhält einen der folgenden Werte, um den Residency-Status der entsprechenden Zuordnung in dem Array anzugeben, das durch HandleListangegeben wird.
| Wert | Bedeutung |
|---|---|
| D3DDDI_RESIDENCYSTATUS_RESIDENTINGPUMEMORY (1) | Die Ressource oder Liste der Zuordnungen befindet sich im GPU-Speicher, der den höchsten Residency-Status darstellt. |
| D3DDDI_RESIDENCYSTATUS_RESIDENTINSHAREDMEMORY (2) | Die Ressource oder Liste der Zuordnungen befindet sich im freigegebenen Speicher. |
| D3DDDI_RESIDENCYSTATUS_NOTRESIDENT (3) | Die Ressource oder Liste der Zuordnungen ist nichtident, was der niedrigste Residency-Status ist. |
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Verfügbar in Windows Vista und höheren Versionen der Windows-Betriebssysteme. |
| Header- | d3dumddi.h (include D3dumddi.h) |