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