NdisAllocateMdl 関数 (ndis/mdlapi.h)

[アーティクル]
02/26/2024

NdisAllocateMdl 関数は、指定された仮想アドレスにメモリバッファーを記述する MDL を割り当てます。

構文

NDIS_EXPORTED_ROUTINE MDL * NdisAllocateMdl(
  [in] NDIS_HANDLE NdisHandle,
  [in] PVOID       VirtualAddress,
  [in] ULONG       Length
);

パラメーター

[in] NdisHandle

呼び出し元の初期化中に取得された NDIS ハンドル。詳細については、「プールハンドルの取得」を参照してください。

[in] VirtualAddress

MDL が記述するバッファーのベース仮想アドレスへのポインター。

重要

NdisAllocateMdl の VirtualAddress パラメーターは、非ページプールからのメモリのみを受け入れます。つまり、 ExAllocatePool*(NonPagedNx)、 NdisAllocateMemoryWithTagPriority、または NdisMAllocateSharedMemory からのメモリが必要です。特に、スタック、ページプール、ドライバーグローバルデータ、またはその他のメモリ領域からのメモリでは使用 しないでください 。

ドライバーは、これらの非ページプール領域のいずれかの MDL を構築する必要がある場合は、IoAllocateMdl と MmProbeAndLockPages を組み合わせたなど、その種類のメモリに適切なカーネル API を使用する必要があります。

[in] Length

メモリバッファーのサイズ (バイト単位)。

戻り値

NdisAllocateMdl は 、割り当てられた MDL へのポインターを返します。割り当てが失敗した場合、戻り値は NULL です。

注釈

NdisAllocateMdl を呼び出すことによって割り当てられるすべての MDL は、NdisFreeMdl 関数を呼び出すことによって解放する必要があります。

NdisAllocateMdl はメモリを割り当て、1 つの手順で MDL をビルドします。このプロセスは、MDL のメモリのみを割り当てる IoAllocateMdl とは異なります。つまり、呼び出し元は MmBuildMdlForNonPagedPool または MmProbeAndLockPages を呼び出して MDL をビルドする必要があります。

要件

要件	値
サポートされている最小のクライアント	NDIS 6.0 以降でサポートされています。
対象プラットフォーム	ユニバーサル
最小 UMDF バージョン	2.33
Header	ndis/mdlapi.h (ndis.h を含む)
Library	Ndis.lib
IRQL	<= DISPATCH_LEVEL
DDI コンプライアンス規則	Irql_NetBuffer_Function(ndis)、 NdisAllocateMdl(ndis)