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

Статья
08/08/2023

Функция 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 , который указывает фактический базовый адрес, по которому требуется отменить сопоставление виртуальной памяти.

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

None

Remarks

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

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

Требования

Требование	Значение
Минимальная версия клиента	Доступно в Windows 2000 и более поздних версиях операционных систем Windows.
Целевая платформа	Персональный компьютер
Верхняя часть	videoagp.h (включая Video.h)
IRQL	PASSIVE_LEVEL

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

AgpCommitVirtual