IDXGIDevice::QueryResourceResidency-Methode (dxgi.h)

Artikel
08/23/2023

Ruft die Residency-status eines Ressourcenarrays ab.

Syntax

HRESULT QueryResourceResidency(
  [in]  IUnknown       * const *ppResources,
  [out] DXGI_RESIDENCY *pResidencyStatus,
        UINT           NumResources
);

Parameter

[in] ppResources

Typ: IUnknown*

Ein Array von IDXGIResource-Schnittstellen .

[out] pResidencyStatus

Typ: DXGI_RESIDENCY*

Ein Array von DXGI_RESIDENCY Flags. Jedes Element beschreibt die Residency-status für das entsprechende Element im Argumentarray ppResources.

NumResources

Typ: UINT

Die Anzahl der Ressourcen im Argumentarray ppResources und im Argumentarray pResidencyStatus .

Rückgabewert

Typ: HRESULT

Gibt bei erfolgreicher Ausführung S_OK zurück. gibt andernfalls DXGI_ERROR_DEVICE_REMOVED, E_INVALIDARG oder E_POINTER zurück (weitere Informationen finden Sie unter Allgemeine HRESULT-Werte und WinError.h).

Hinweise

Die vom pResidencyStatus-Argumentarray zurückgegebenen Informationen beschreiben die Residency-status zum Zeitpunkt des Aufrufs der QueryResourceResidency-Methode.

Hinweis Die Residenz status wird sich ständig ändern.

Wenn Sie die QueryResourceResidency-Methode während eines gerätefernen Zustands aufrufen, gibt das pResidencyStatus-Argument das flag DXGI_RESIDENCY_RESIDENT_IN_SHARED_MEMORY zurück.

Hinweis Diese Methode sollte nicht jeden Frame aufgerufen werden, da ein nicht trivialer Mehraufwand entsteht.

Anforderungen

Anforderung	Wert
Zielplattform	Windows
Kopfzeile	dxgi.h
Bibliothek	DXGI.lib

Weitere Informationen

DXGI-Schnittstellen

IDXGIDevice

Freigeben über