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 对象,然后仅在持有互斥时调用 ReclaimResources1

要求

   
目标平台 Windows
标头 dxgi1_5.h
Library Dxgi.lib
DLL Dxgi.dll

请参阅

IDXGIDevice4

ReclaimResources