核心API之IoAllocateMdl

IoAllocateMdl

 IoAllocateMdl 函數分配足夠映射一塊緩衝的MDL,給定緩衝的起始地址和長度.

PMDL
IoAllocateMdl(
    __in_opt PVOID VirtualAddress,
    __in ULONG Length,
    __in BOOLEAN SecondaryBuffer,
    __in BOOLEAN ChargeQuota,
    __inout_opt PIRP Irp OPTIONAL
    );

驅動可以使用IoAllocateMdl 函數實現大緩衝分區的目的，通過一個獨立的MDL來映射緩衝的一小部分，或者映射驅動分配的記憶體.驅動會調用MmBuildMdlForNonPagedPool 來設定MDL的記憶體，使得MDL描述驅動分配的緩衝處於不可置換的記憶體中。

 Length參數指明了MDL指向的緩衝的大小。在Windows Server 2003, Windows XP, 和Windows 2000, 能夠分配的最大緩衝位元組數為PAGE_SIZE * (65535 - sizeof(MDL)) / sizeof(ULONG_PTR)。在Windows Vista和Windows Server 2008, 最大緩衝位元組數是(2GB - PAGE_SIZE).在Windows 7和Windows Server 2008 R2中, 最大緩衝位元組數是(4GB - PAGE_SIZE).

   如果SecondaryBuffer參數是FALSE, 這個函數會更新Irp->MdlAddress ,讓它指向一個新的MDL， 也就是說讓它支援大緩衝分區吧。 如果SecondaryBuffer為TRUE, 這個函數把MDL添加到Irp->MdlAddress指向的鏈之後。