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 |