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 函式,NDIS 會呼叫 NetAllocateMdl 來配置 MDL 和記憶體。
NDIS 指定 BufferSize 上相關聯記憶體區塊的大小。
NetAllocateMdl 可以使用符合驅動程序設計需求的任何配置方法。 當 NDIS 呼叫 NetFreeMdl 函式以釋放記憶體時,NDIS 驅動程式應該使用用來配置記憶體的相同記憶體管理機制來釋放記憶體。
NDIS 會在 IRQL <= DISPATCH_LEVEL呼叫 NetAllocateMdl。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | NDIS 6.0 和更新版本支援。 |
標頭 | nblapi.h (include ndis.h) |
IRQL | <= DISPATCH_LEVEL |