IDXGIDevice2::ReclaimResources-Methode (dxgi1_2.h)

  • Artikel

Stellt den Zugriff auf Ressourcen wieder her, die zuvor durch Aufrufen von IDXGIDevice2::OfferResources angeboten wurden.

Syntax

HRESULT ReclaimResources(
  [in]            UINT          NumResources,
  [in]            IDXGIResource * const *ppResources,
  [out, optional] BOOL          *pDiscarded
);

Parameter

[in] NumResources

Die Anzahl der Ressourcen in den Argumenten ppResources und pDiscarded-Argumentarrays .

[in] ppResources

Ein Array von Zeigern auf IDXGIResource-Schnittstellen für die zurückzufordernden Ressourcen.

[out, optional] pDiscarded

Ein Zeiger auf ein Array, das boolesche Werte empfängt. Jeder Wert im Array entspricht einer Ressource im selben Index, den der ppResources-Parameter angibt. Die Runtime legt jeden booleschen Wert auf TRUE fest, wenn der Inhalt der entsprechenden Ressource verworfen wurde und jetzt nicht definiert ist, oder auf FALSE, wenn der alte Inhalt der entsprechenden Ressource noch intakt ist. Der Aufrufer kann NULL übergeben, wenn der Aufrufer die Ressourcen unabhängig davon, ob der alte Inhalt verworfen wurde, mit neuen Inhalten füllen möchte.

Rückgabewert

ReclaimResources gibt Folgendes zurück:

  • S_OK, wenn Ressourcen erfolgreich zurückgewonnen wurden
  • E_INVALIDARG, wenn die Ressourcen ungültig sind

Hinweise

Nachdem Sie IDXGIDevice2::OfferResources aufgerufen haben , um eine oder mehrere Ressourcen anzubieten, müssen Sie ReclaimResources aufrufen, bevor Sie diese Ressourcen erneut verwenden können. Sie müssen die Werte im Array bei pDiscarded überprüfen, um zu ermitteln, ob der Inhalt jeder Ressource verworfen wurde. Wenn der Inhalt einer Ressource verworfen wurde, während sie angeboten wurde, ist der aktuelle Inhalt nicht definiert. Daher müssen Sie den Inhalt der Ressource überschreiben, bevor Sie die Ressource verwenden.

Um freigegebene Ressourcen zurückzugeben, rufen Sie ReclaimResources nur auf einem der Freigegebenen Geräte auf. Um den exklusiven Zugriff auf die Ressourcen sicherzustellen, müssen Sie ein IDXGIKeyedMutex-Objekt verwenden und dann ReclaimResources nur aufrufen, wenn Sie den Mutex halten.

Plattformupdate für Windows 7: Die Runtime überprüft, ob ReclaimResources für nicht freigegebene Ressourcen ordnungsgemäß verwendet wird, aber nicht die beabsichtigte Funktionalität ausführt. Weitere Informationen zum Plattformupdate für Windows 7 finden Sie unter Plattformupdate für Windows 7.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows 8 und Plattformupdate für Windows 7 [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2012 und Plattformupdate für Windows Server 2008 R2 [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile dxgi1_2.h
Bibliothek Dxgi.lib

Weitere Informationen

IDXGIDevice2

IDXGIDevice2::OfferResources