共用方式為


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