D3DKMT_QUERYALLOCATIONRESIDENCY Struktur (d3dkmthk.h)

Die D3DKMT_QUERYALLOCATIONRESIDENCY Struktur beschreibt Informationen zum Abrufen des Residency-Status aus einer Ressource oder Liste von Zuordnungen.

Syntax

typedef struct _D3DKMT_QUERYALLOCATIONRESIDENCY {
  [in]  D3DKMT_HANDLE                    hDevice;
  [in]  D3DKMT_HANDLE                    hResource;
  [in]  const D3DKMT_HANDLE              *phAllocationList;
  [in]  UINT                             AllocationCount;
  [out] D3DKMT_ALLOCATIONRESIDENCYSTATUS *pResidencyStatus;
} D3DKMT_QUERYALLOCATIONRESIDENCY;

Angehörige

[in] hDevice

Ein D3DKMT_HANDLE Datentyp, der ein Kernelmodushandle für das Gerät darstellt, dem die Ressource oder Liste der Zuordnungen zugeordnet sind.

[in] hResource

Ein Handle für eine Ressource, deren Residency abgefragt wird. Wenn das OpenGL ICD das Array verwendet, das phAllocationList angibt, um die Residency abzufragen, wird hResource- auf NULL-festgelegt. Wenn die OpenGL ICD hResource- auf einen Wert ohneNULL- festlegt, muss das AllocationCount Member auf Null und phAllocationList- auf NULL-festgelegt werden.

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.

Wenn eine Zuordnung, die zur Ressource gehört, nicht ansässig ist, wird die gesamte Ressource als nicht gebietsansässig betrachtet.

Um detaillierte Residency-Informationen zu jeder Zuordnung abzurufen, die zu einer Ressource gehört, muss die Zuordnung abgefragt werden.

[in] phAllocationList

Ein Array von D3DKMT_HANDLE Datentypen, die Kernelmodushandles für die Zuordnungen darstellen. Das OpenGL ICD verwendet diese Handles, um den Residency-Status abzufragen.

Wenn das OpenGL ICD den Handle im hResource--Member auf einen Nicht-NULL--Wert festlegt, muss er phAllocationList- auf NULL-festlegen.

[in] AllocationCount

Die Anzahl der Zuordnungen im Array, das phAllocationList- angibt. Wenn das OpenGL ICD den Handle im hResource Member auf einen Wert ungleichNULL festlegt, muss er AllocationCount- auf Null festlegen.

[out] pResidencyStatus

Ein Zeiger auf ein Array von D3DKMT_ALLOCATIONRESIDENCYSTATUS Enumerationen. Wenn das hResource Mitglied nichtNULL-ist, enthält das Array ein einzelnes Element und erhält einen der Enumerationselemente, die in der folgenden Tabelle aufgeführt sind, um den Residency-Status der Ressource anzugeben. Wenn hResource-NULL-ist, wird die Anzahl der Elemente im Array durch das AllocationCount Member angegeben, und jedes Element empfängt einen der folgenden Enumerationen, um den Residency-Status der entsprechenden Zuordnung im phAllocationList Array anzugeben.

Anforderungen

Siehe auch

D3DKMTQueryAllocationResidency