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 |