функция обратного вызова PFND3DDDI_RECLAIMRESOURCES (d3dumddi.h)

Статья
08/07/2023

Вызывается средой выполнения Microsoft Direct3D для освобождения ресурсов видеопамять, которые она ранее предлагала для повторного использования.

Синтаксис

PFND3DDDI_RECLAIMRESOURCES Pfnd3dddiReclaimresources;

HRESULT Pfnd3dddiReclaimresources(
  HANDLE hDevice,
  const D3DDDIARG_RECLAIMRESOURCES *unnamedParam2
)
{...}

Параметры

hDevice

Дескриптор устройства отображения (графический контекст).

unnamedParam2

pData [in]

Указатель на структуру D3DDDIARG_RECLAIMRESOURCES , которая определяет ресурсы видеопамять для освобождения.

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

Возвращает одно из следующих значений:

Код возврата	Описание
S_OK	Ресурсы видеопамять были успешно освобождены. Этот код ошибки возвращается, если драйверу не нужно вызывать функцию pfnReclaimAllocationsCb .
E_INVALIDARG	Указан недопустимый параметр. Этот код ошибки возвращается, если драйвер вызывает функцию pfnReclaimAllocationsCb и эта функция возвращает E_INVALIDARG.
D3DDDIERR_DEVICEREMOVED	Диспетчеру видеопамяти или драйверу минипорта дисплея не удалось завершить операцию, так как произошло событие остановки Plug and Play (PnP) или событие обнаружения и восстановления времени ожидания (TDR). Этот код ошибки возвращается, если драйвер вызывает функцию pfnReclaimAllocationsCb и эта функция возвращает D3DDDIERR_DEVICEREMOVED. Примечание: Если этот код ошибки возвращается, вызывающая функция драйвера (обычно это подпрограмма ReclaimResourcesDXGI ) должна вернуть этот код ошибки в среду выполнения Direct3D.

Требования

Требование	Значение
Минимальная версия клиента	Windows 8
Минимальная версия сервера	Windows Server 2012
Целевая платформа	Персональный компьютер
Верхняя часть	d3dumddi.h (включая D3dumddi.h)

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

D3DDDIARG_RECLAIMRESOURCES

D3DDDI_DEVICEFUNCS

OfferResources

ReclaimResourcesDXGI

pfnReclaimAllocationsCb