Метод IDXGIDevice2::ReclaimResources (dxgi1_2.h)

Статья
08/23/2023

Восстанавливает доступ к ресурсам, которые были ранее предложены путем вызова IDXGIDevice2::OfferResources.

Синтаксис

HRESULT ReclaimResources(
  [in]            UINT          NumResources,
  [in]            IDXGIResource * const *ppResources,
  [out, optional] BOOL          *pDiscarded
);

Параметры

[in] NumResources

Количество ресурсов в аргументе ppResources и массивахаргументов pDiscarded .

[in] ppResources

Массив указателей на интерфейсы IDXGIResource для ресурсов, которые требуется освободить.

[out, optional] pDiscarded

Указатель на массив, получающий логические значения. Каждое значение в массиве соответствует ресурсу с тем же индексом, что и параметр ppResources . Среда выполнения присваивает каждому логическому значению значение TRUE, если содержимое соответствующего ресурса было удалено и теперь не определено, или значение FALSE, если старое содержимое соответствующего ресурса по-прежнему нетронуто. Вызывающий объект может передать значение NULL, если вызывающий объект намерен заполнить ресурсы новым содержимым независимо от того, было ли удалено старое содержимое.

Возвращаемое значение

ReclaimResources возвращает:

S_OK, если ресурсы были успешно освобождены
E_INVALIDARG, если ресурсы недопустимы

После вызова МЕТОДА IDXGIDevice2::OfferResources для предложения одного или нескольких ресурсов необходимо вызвать ReclaimResources , прежде чем использовать эти ресурсы снова. Чтобы определить, было ли удалено содержимое каждого ресурса, необходимо проверка значения в массиве pDiscarded. Если содержимое ресурса было удалено во время его предлагаться, его текущее содержимое не определено. Поэтому перед использованием ресурса необходимо перезаписать содержимое ресурса.

Чтобы освободить общие ресурсы, вызовите ReclaimResources только на одном из устройств с общим доступом. Чтобы обеспечить монопольный доступ к ресурсам, необходимо использовать объект IDXGIKeyedMutex , а затем вызывать ReclaimResources только во время хранения мьютекса.

Обновление платформы для Windows 7: Среда выполнения проверяет, правильно ли используется ReclaimResources для ресурсов, не являющихся общими, но не выполняет требуемые функции. Дополнительные сведения об Обновлении платформы для Windows 7 см. в разделе Обновление платформы для Windows 7.

Требования


Минимальная версия клиента	Windows 8 и Обновление платформы для Windows 7 [классические приложения \| Приложения UWP]
Минимальная версия сервера	Windows Server 2012 и обновление платформы для Windows Server 2008 R2 [классические приложения \| Приложения UWP]
Целевая платформа	Windows
Header	dxgi1_2.h
Библиотека	Dxgi.lib

См. также раздел

IDXGIDevice2

IDXGIDevice2::OfferResources