IDXGIDevice2：：ReclaimResources 方法 (dxgi1_2.h)

  • 發行項

還原先前藉由呼叫 IDXGIDevice2：：OfferResources所提供的資源存取權。

語法

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

參數

[in] NumResources

ppResources引數和pDiscarded引數陣列中的資源數目。

[in] ppResources

要回收之資源的 IDXGIResource 介面指標陣列。

[out, optional] pDiscarded

接收布林值的陣列指標。 陣列中的每個值都會對應至 ppResources 參數所指定之相同索引的資源。 如果已捨棄對應的資源內容且現在未定義，則執行時間會將每個布林值設定為 TRUE，如果對應的資源舊內容仍然保持不變，則設定為 FALSE。 如果呼叫端想要以新內容填滿資源，則呼叫端可以傳入 Null，而不論是否捨棄舊內容。

傳回值

ReclaimResources 會 傳回：

  • 如果已成功回收資源，S_OK
  • 如果資源無效，E_INVALIDARG

備註

呼叫 IDXGIDevice2：：OfferResources 以提供一或多個資源之後，您必須先呼叫 ReclaimResources ，才能再次使用這些資源。 您必須檢查 pDiscarded 陣列中的值，以判斷是否已捨棄每個資源的內容。 如果資源的內容在提供時遭到捨棄，則其目前的內容是未定義的。 因此，您必須先覆寫資源的內容，才能使用資源。

若要回收共用資源，請只在其中一個共用裝置上呼叫 ReclaimResources 。 若要確保資源的獨佔存取權，您必須使用 IDXGIKeyedMutex 物件，然後在您保存 Mutex 時呼叫 ReclaimResources 。

適用于 Windows 7 的平臺更新： 執行時間會驗證在非共用資源上正確使用 ReclaimResources ，但不會執行預期的功能。 如需 Windows 7 平臺更新的詳細資訊，請參閱 適用于 Windows 7 的平臺更新。

需求

   
最低支援的用戶端 適用于 Windows 7 的 Windows 8 和平臺更新 [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 適用于 Windows Server 2008 R2 的 Windows Server 2012 和平臺更新 [傳統型應用程式 |UWP 應用程式]
目標平台 Windows
標頭 dxgi1_2.h
程式庫 Dxgi.lib

另請參閱

IDXGIDevice2

IDXGIDevice2：：OfferResources