D3DDDICB_QUERYRESIDENCY Struktur (d3dumddi.h)
Die D3DDDICB_QUERYRESIDENCY-Struktur beschreibt die Residenz status einer Ressource oder Einer Liste von Zuordnungen.
Syntax
typedef struct _D3DDDICB_QUERYRESIDENCY {
[in] HANDLE hResource;
[in] UINT NumAllocations;
[in] const D3DKMT_HANDLE *HandleList;
[out] D3DDDI_RESIDENCYSTATUS *pResidencyStatus;
} D3DDDICB_QUERYRESIDENCY;
Member
[in] hResource
Ein Handle für eine Ressource, deren Wohnsitz abgefragt wird. Wenn der Benutzermodusanzeigetreiber das Array im HandleList-Member verwendet, um die Residency abzufragen, legt er hResource auf NULL fest.
Wenn hResource nicht NULL ist, werden alle Zuordnungen abgefragt, die zur Ressource gehören, und das Ergebnis wird im ersten Element des Arrays zurückgegeben, auf das pResidencyStatus verweist. Die status einer Ressource entspricht dem niedrigsten Wohnsitz status aller Zuordnungen, die zur Ressource gehören.
[in] NumAllocations
Die Anzahl der Zuordnungen im HandleList-Array . Wenn der Benutzermodusanzeigetreiber das Handle im hResource-Member auf nicht NULL festlegt, muss NumAllocations auf 0 festgelegt werden.
[in] HandleList
Ein Array von D3DKMT_HANDLE Datentypen, die Kernelmodushandles für die Zuordnungen darstellen. Die PfnAllocateCb-Funktion der Microsoft Direct3D-Runtime gibt diese Handles zurück. Daher verwendet der Benutzermodusanzeigetreiber diese Handles, um die Residenz abzufragen.
Wenn der Benutzermodusanzeigetreiber das Handle im hResource-Member auf nicht NULL festlegt, muss HandleList auf NULL festgelegt werden.
[out] pResidencyStatus
Ein Zeiger auf ein Array von D3DDDI_RESIDENCYSTATUS Werten. Wenn das hResource-Element nicht NULL ist, enthält das Array ein einzelnes Element und empfängt einen der folgenden Werte, um den Residency-status der Ressource anzugeben. Wenn hResourceNULL ist, wird die Anzahl der Elemente im Array vom NumAllocations-Member angegeben, und jedes Element erhält einen der folgenden Werte, um die Residency status der entsprechenden Zuordnung in dem Array anzugeben, das von HandleList angegeben wird.
| Wert | Bedeutung |
|---|---|
| D3DDDI_RESIDENCYSTATUS_RESIDENTINGPUMEMORY (1) | Die Ressource oder Liste der Zuordnungen befinden sich im GPU-Arbeitsspeicher, der höchsten Status. |
| D3DDDI_RESIDENCYSTATUS_RESIDENTINSHAREDMEMORY (2) | Die Ressource oder Liste der Zuordnungen befinden sich im freigegebenen Arbeitsspeicher. |
| D3DDDI_RESIDENCYSTATUS_NOTRESIDENT (3) | Die Ressource oder Liste der Zuordnungen ist nichtresident, was der niedrigste Wohnsitz status ist. |
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Verfügbar in Windows Vista und höheren Versionen der Windows-Betriebssysteme. |
| Kopfzeile | d3dumddi.h (include D3dumddi.h) |