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

  • Статья

Функция AgpCommitPhysical сопоставляет системную (физическую) память с указанным диапазоном физических адресов, декодируемых AGP.

Синтаксис

PAGP_COMMIT_PHYSICAL PagpCommitPhysical;

BOOLEAN PagpCommitPhysical(
  [in] IN PVOID HwDeviceExtension,
  [in] IN PVOID PhysicalReserveContext,
  [in] IN ULONG Pages,
  [in] IN ULONG Offset
)
{...}

Параметры

[in] HwDeviceExtension

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

[in] PhysicalReserveContext

Определяет зарезервированный диапазон физических адресов. Дескриптор контекста получается из AgpReservePhysical.

[in] Pages

Указывает количество страниц системной памяти для фиксации.

[in] Offset

Указывает смещение страницы для фиксации страниц. Смещение применяется к диапазону зарезервированных физических адресов, связанному с PhysicalReserveContext.

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

AgpCommitPhysical возвращает значение TRUE , если сопоставление прошло успешно, и false в противном случае.

Комментарии

Драйвер видео минипорта должен сначала зарезервировать физические адреса, вызвав AgpReservePhysical , прежде чем вызывать эту функцию.

Не вызывайте AgpCommitPhysical для фиксации адресов, которые уже были зафиксированы. Если диапазон страниц, указанный в PhysicalReserveContext, Pages и Offset , включает все ранее зафиксированные страницы, AgpCommitPhysical может завершиться ошибкой.

Драйверы видео минипорта, которые работают в Microsoft Windows 2000, всегда должны резервировать и фиксировать физический диапазон, размер которого кратен 64 килобайтам. Резервирование или фиксация физического диапазона, не кратного 64 килобайта, может привести к тому, что AgpReserveVirtual или AgpCommitVirtual вернет недопустимый виртуальный адрес.

В Windows XP и более поздних версий AgpCommitPhysical автоматически расширяет зафиксированный диапазон, кратный 64 килобайтам.

Когда драйвер видео минипорта вызывает AgpCommitPhysical, часть диапазона физических адресов, определяемого PhysicalReserveContext , сопоставляется с заблокированными страницами физической памяти. Сопоставленная часть начинает страницы Смещения в диапазоне, определяемом PhysicalReserveContext. Драйвер видео минипорта может получить доступ к зафиксированной физической памяти, как если бы она была непрерывной.

Требования

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

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

AgpCommitVirtual

AgpReservePhysical

AgpReserveVirtual