IDXGIDevice4::ReclaimResources1 方法 (dxgi1_5.h)
藉由呼叫 IDXGIDevice4::OfferResources1,還原先前提供之資源的存取權。
語法
HRESULT ReclaimResources1(
[in] UINT NumResources,
[in] IDXGIResource * const *ppResources,
[out] DXGI_RECLAIM_RESOURCE_RESULTS *pResults
);
參數
[in] NumResources
類型: UINT
ppResources引數和pResults引數陣列中的資源數目。
[in] ppResources
類型: IDXGIResource*
要回收之資源的 IDXGIResource 介面指標陣列。
[out] pResults
類型: DXGI_RECLAIM_RESOURCE_RESULTS*
接收 DXGI_RECLAIM_RESOURCE_RESULTS 值的陣列指標。 陣列中的每個值都會對應至 ppResources 參數所指定之相同索引的資源。 如果呼叫端想要以新內容填滿資源,不論舊內容是否已捨棄,呼叫端都可以傳入 Null。
傳回值
類型: HRESULT
此方法會傳回 HRESULT 成功或錯誤碼,包括資源無效時E_INVALIDARG。
備註
呼叫 OfferResources1 以提供一或多個資源之後,您必須先呼叫 ReclaimResources1 ,才能再次使用這些資源。
若要回收共用資源,請只在其中一個共用裝置上呼叫 ReclaimResources1 。 若要確保資源的獨佔存取權,您必須使用 IDXGIKeyedMutex 物件,然後只在您保存 mutex 時呼叫 ReclaimResources1 。
需求
目標平台 | Windows |
標頭 | dxgi1_5.h |
程式庫 | Dxgi.lib |
Dll | Dxgi.dll |