IDXGIDevice4::ReclaimResources1-Methode (dxgi1_5.h)
Stellt den Zugriff auf Ressourcen wieder her, die zuvor durch Aufrufen von IDXGIDevice4::OfferResources1 angeboten wurden.
Syntax
HRESULT ReclaimResources1(
[in] UINT NumResources,
[in] IDXGIResource * const *ppResources,
[out] DXGI_RECLAIM_RESOURCE_RESULTS *pResults
);
Parameter
[in] NumResources
Typ: UINT
Die Anzahl der Ressourcen in den Argumentarrays ppResources und pResults .
[in] ppResources
Typ: IDXGIResource*
Ein Array von Zeigern auf IDXGIResource-Schnittstellen für die ressourcen, die abgerufen werden sollen.
[out] pResults
Typ: DXGI_RECLAIM_RESOURCE_RESULTS*
Ein Zeiger auf ein Array, das DXGI_RECLAIM_RESOURCE_RESULTS Werte empfängt. Jeder Wert im Array entspricht einer Ressource mit demselben Index, den der ppResources-Parameter angibt. Der Aufrufer kann NULL übergeben, wenn der Aufrufer die Ressourcen mit neuen Inhalten füllen möchte, unabhängig davon, ob der alte Inhalt verworfen wurde.
Rückgabewert
Typ: HRESULT
Diese Methode gibt einen HRESULT-Erfolgs- oder Fehlercode zurück, einschließlich E_INVALIDARG, wenn die Ressourcen ungültig sind.
Hinweise
Nachdem Sie OfferResources1 aufgerufen haben , um eine oder mehrere Ressourcen anzubieten, müssen Sie ReclaimResources1 aufrufen, bevor Sie diese Ressourcen erneut verwenden können.
Um freigegebene Ressourcen freizugeben, rufen Sie ReclaimResources1 nur auf einem der Freigabegeräte auf. Um den exklusiven Zugriff auf die Ressourcen sicherzustellen, müssen Sie ein IDXGIKeyedMutex-Objekt verwenden und dann ReclaimResources1 nur aufrufen, während Sie den Mutex halten.
Anforderungen
| Zielplattform | Windows |
| Kopfzeile | dxgi1_5.h |
| Bibliothek | Dxgi.lib |
| DLL | Dxgi.dll |