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

Восстанавливает доступ к ресурсам, которые были ранее предложены путем вызова 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.

Требования

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

IDXGIDevice2

IDXGIDevice2::OfferResources