функция обратного вызова 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 (include Video.h) |
| IRQL | PASSIVE_LEVEL |