Макрос MmGetSystemAddressForMdl (wdm.h)
Подпрограмма MmGetSystemAddressForMdl устарела. Вместо этого используйте MmGetSystemAddressForMdlSafe .
MmGetSystemAddressForMdl — это макрос, возвращающий непагрегированный виртуальный адрес системного пространства для буфера, описанного в MDL. Он сопоставляет физические страницы, описанные заданным MDL, в системное пространство, если они еще не сопоставлены с системным пространством.
Синтаксис
PVOID MmGetSystemAddressForMdl(
MDL
);
Параметры
[in] MDL
Указатель на буфер, для которого необходимо сопоставить соответствующий базовый виртуальный адрес.
Возвращаемое значение
None
Remarks
MmGetSystemAddressForMdl возвращает виртуальный адрес базового системного пространства, который сопоставляет физические страницы, описанные данным MDL.
Драйверы устройств piO вызывают эту подпрограмму для преобразования диапазона виртуальных адресов, описанного в MDL в Irp-MdlAddress>, для буфера пользователя в диапазон адресов системного пространства.
MDL должен описывать непаджируемую память. Иными словами, входной MDL должен описывать уже заблокированный буфер пользовательского пространства, возвращаемый MmProbeAndLockPages, заблокированный буфер, возвращаемый MmBuildMdlForNonPagedPool, или системную память, выделенную из непагрегированного пула, непрерывной памяти или не кэшируемой памяти.
Возвращаемый базовый адрес имеет то же смещение, что и виртуальный адрес в MDL.
Окно выдает ошибку проверка, если попытка сопоставления с системным пространством завершается ошибкой. Поэтому вместо этого следует использовать MmGetSystemAddressForMdlSafe .
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Является устаревшей. Вместо этого используйте MmGetSystemAddressForMdlSafe. |
| Целевая платформа | Персональный компьютер |
| Верхняя часть | wdm.h (включая Wdm.h, Ntddk.h, Ntifs.h) |
| IRQL | IRQL <= DISPATCH_LEVEL |