MmGetMdlVirtualAddress macro (wdm.h)
The MmGetMdlVirtualAddress macro returns the base virtual address of a buffer described by an MDL.
Syntax
PVOID
MmGetMdlVirtualAddress (
_In_ PMDL Mdl
)
Parameters
[in] Mdl
Pointer to an MDL that describes the buffer for which to return the initial virtual address.
Return value
None
Remarks
MmGetMdlVirtualAddress returns the starting virtual address of the MDL.
MmGetMdlVirtualAddress returns a virtual address that is not necessarily valid in the current thread context. Lower-level drivers should not attempt to use the returned virtual address to access memory, particularly user memory space.
The returned address, used as an index to a physical address entry in the MDL, can be input to MapTransfer.
Callers of MmGetMdlVirtualAddress can be running at any IRQL. Usually, the caller is running at IRQL = DISPATCH_LEVEL because this routine is commonly called to obtain the CurrentVa parameter to MapTransfer.
Requirements
Requirement | Value |
---|---|
Minimum supported client | Windows 2000 |
Header | wdm.h |
IRQL | Any level (see Remarks) |
DDI compliance rules | MdlAfterReqCompletedIntIoctlA(kmdf), MdlAfterReqCompletedIoctlA(kmdf), MdlAfterReqCompletedReadA(kmdf), MdlAfterReqCompletedWriteA(kmdf) |