Share via

IDXGIDevice4::ReclaimResources1-Methode (dxgi1_5.h)

  • Artikel

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

Weitere Informationen

IDXGIDevice4

ReclaimResources