(wdm.h) IoFreeMdl 函式
IoFreeMdl 例程會釋放呼叫端配置的記憶體描述元清單, (MDL) 。
語法
void IoFreeMdl(
[in] PMDL Mdl
);
參數
[in] Mdl
要釋放之 MDL 的指標。
傳回值
無
備註
如果驅動程式配置 MDL 來描述緩衝區,當緩衝區上的作業完成時,它必須明確釋放 MDL。
如果 MDL 是部分 MDL,IoFreeMdl 會取消對應到 MDL 的任何頁面。
如果 MDL 所描述的實體頁面已鎖定,驅動程式必須先解除鎖定頁面,才能釋放 MDL。
這個例程只會釋放指定的 MDL。 鏈結至此 MDL 的任何 MDL 都必須透過此例程的其他呼叫明確釋放。 如需示範如何釋放 MDL 鏈結的程式代碼範例,請參閱 使用 MDLs。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | 從 Windows 2000 開始提供。 |
目標平台 | Universal |
標頭 | wdm.h (包括 Wdm.h、Ntddk.h、Ntifs.h) |
程式庫 | NtosKrnl.lib |
Dll | NtosKrnl.exe |
IRQL | <= DISPATCH_LEVEL |