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

另請參閱

IDXGIDevice4

ReclaimResources