IoAllocateMdl 関数 (wdm.h)
IoAllocateMdl ルーチンは、バッファーの開始アドレスと長さを指定して、バッファーをマップするのに十分な大きさのメモリ記述子リスト (MDL) を割り当てます。 必要に応じて、このルーチンは、MDL を IRP に関連付けます。
構文
PMDL IoAllocateMdl(
[in, optional] __drv_aliasesMem PVOID VirtualAddress,
[in] ULONG Length,
[in] BOOLEAN SecondaryBuffer,
[in] BOOLEAN ChargeQuota,
[in, out, optional] PIRP Irp
);
パラメーター
[in, optional] VirtualAddress
MDL が記述するバッファーのベース仮想アドレスへのポインター。
[in] Length
MDL が記述するバッファーの長さをバイト単位で指定します。 詳細については、「解説」を参照してください。
[in] SecondaryBuffer
バッファーがプライマリ バッファーかセカンダリ バッファーかを示します。 このパラメーターは、MDL を IRP にリンクする方法を決定します。 IRP の MDL によって記述された最初のバッファーを除くすべてのバッファーは、セカンダリ バッファーと見なされます。 IRP が MDL に関連付けられていない場合、このフィールドは FALSE である必要があります。 詳細については、「解説」を参照してください。
[in] ChargeQuota
システムで使用するために予約されています。 ドライバーは、このパラメーターを FALSE に設定する必要があります。
[in, out, optional] Irp
MDL に関連付ける IRP へのポインター。 Irp ポインターが NULL 以外の場合、割り当てられた MDL は、SecondaryBuffer の値に従って、指定された IRP の MDL リストに関連付けられます。
戻り値
IoAllocateMdl は MDL へのポインターを返すか、MDL を割り当てることができない場合は NULL を返します。
注釈
IoAllocateMdl は、バッファーを分割して個別の MDL によってマップする必要があるドライバー、またはドライバーによって割り当てられたバッファーをマップする必要があるドライバーで使用できます。 ドライバーは、この呼び出しによって割り当てられた MDL を使用して MmBuildMdlForNonPagedPool を呼び出して、非ページ プール内のドライバー割り当てバッファーを記述する MDL を設定する必要があります。
Length パラメーターは、MDL によって記述されるバッファーのサイズを指定します。 Windows Server 2003、Windows XP、Windows 2000 では、このルーチンが割り当てることができる最大バッファー サイズ (バイト単位) PAGE_SIZE は、 * (65535 - sizeof(MDL)) / sizeof(ULONG_PTR) です。 Windows Vista および Windows Server 2008 では、最大バッファー サイズは (2 ギガバイト - PAGE_SIZE) です。 Windows 7 および Windows Server 2008 R2 以降では、最大バッファー サイズは (4 ギガバイト - PAGE_SIZE) です。
SecondaryBuffer パラメーターが FALSE の場合、ルーチンは新しい MDL を指す Irp-MdlAddress> を更新します。 SecondaryBuffer が TRUE の場合、ルーチンは、Irp-MdlAddress> が指す MDL チェーンの末尾に MDL を追加します。
MDL の詳細については、「MDL の使用」を参照してください。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 2000 以降で使用できます。 |
| 対象プラットフォーム | ユニバーサル |
| Header | wdm.h (Wdm.h、Ntddk.h、Ntifs.h を含む) |
| Library | NtosKrnl.lib |
| [DLL] | NtosKrnl.exe |
| IRQL | <= DISPATCH_LEVEL |