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

Статья
02/07/2025

Функция AgpFreeVirtual освобождает виртуальную память, зафиксированную предыдущим вызовом AgpCommitVirtual.

Синтаксис

PAGP_FREE_VIRTUAL PagpFreeVirtual;

void PagpFreeVirtual(
  [in] IN PVOID HwDeviceExtension,
  [in] IN PVOID VirtualReserveContext,
  [in] IN ULONG Pages,
  [in] IN ULONG Offset
)
{...}

Параметры

[in] HwDeviceExtension

Указатель на расширение устройства минипорта драйвера.

[in] VirtualReserveContext

Определяет зарезервированный диапазон виртуальных адресов. Этот дескриптор контекста был получен из AgpReserveVirtual.

[in] Pages

Указывает количество страниц виртуальной памяти, на которых драйвер видеопорта должен распакуироваться.

[in] Offset

Указывает смещение страницы в диапазон зарезервированных виртуальных адресов, определяемый VirtualReserveContext, указывающий фактический базовый адрес, по которому следует распакуировать виртуальную память.

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

Никакой

Замечания

Когда драйвер мини-порта вызывает AgpFreeVirtual, Pages страниц виртуальных адресов распаковываются. Несопоставленный диапазон начинается страницы смещения в диапазон, связанный с VirtualReserveContext. Драйвер минипорта должен указать точное смещение и количество страниц, как было зафиксировано в предыдущем вызове AgpCommitVirtual.

Вызов AgpFreeVirtual необходимо связать с предыдущим вызовом AgpCommitVirtual, и этот вызов AgpCommitVirtual должен предшествовать успешному вызову AgpReserveVirtual. Если AgpReserveVirtual завершается ошибкой (возвращает NULL), не следует вызывать AgpCommitVirtual или AgpFreeVirtual.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Доступно в Windows 2000 и более поздних версиях операционных систем Windows.
целевая платформа	Настольный
заголовка	videoagp.h (include Video.h)
IRQL	PASSIVE_LEVEL

См. также

AgpCommitVirtual

Поделиться через