функция обратного вызова 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 |