NET_BUFFER_ALLOCATE_MDL コールバック関数 (nblapi.h)

NetAllocateMdl 関数は、指定したサイズの関連付けられたメモリブロックを持つ MDL を割り当てます。

構文

NET_BUFFER_ALLOCATE_MDL NetBufferAllocateMdl;

MDL * NetBufferAllocateMdl(
  [in] ULONG *BufferSize
)
{...}

[in] BufferSize

メモリブロックのサイズ (バイト単位)。 NetAllocateMdl を呼び出すと、NDIS は要求されたサイズを渡します。

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

NDIS ドライバーがの AllocateMdl パラメーターで NetAllocateMdl 関数のエントリポイントを指定する場合 NdisRetreatNetBufferDataStart 関数は、 NetAllocateMdl を呼び出して MDL とメモリを割り当てます。

NDIS は、 BufferSize で関連付けられているメモリブロックのサイズを指定します。

NetAllocateMdl では、ドライバーの設計要件を満たす任意の割り当て方法を使用できます。 NDIS が NetFreeMdl 関数を呼び出してメモリを解放する場合、NDIS ドライバーは、メモリの割り当てに使用したのと同じメモリ管理メカニズムを使用してメモリを解放する必要があります。

NDIS は、IRQL <= DISPATCH_LEVELで NetAllocateMdl を呼び出します。