NET_BUFFER_ALLOCATE_MDL Rückruffunktion (nblapi.h)

Die NetAllocateMdl-Funktion weist eine MDL einem zugeordneten Speicherblock einer angegebenen Größe zu.

Syntax

NET_BUFFER_ALLOCATE_MDL NetBufferAllocateMdl;

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

Parameter

[in] BufferSize

Die Größe des Speicherblocks in Bytes. Beim Aufrufen von NetAllocateMdl übergibt NDIS die angeforderte Größe.

Rückgabewert

NetAllocateMdl gibt einen Zeiger auf die zugewiesene MDL zurück. Wenn bei der Zuordnung ein Fehler auftritt, ist der Rückgabewert NULL.

Hinweise

Wenn der NDIS-Treiber einen Einstiegspunkt für die NetAllocateMdl-Funktion am AllocateMdl-Parameter des NdisRetreatNetBufferDataStart-Funktion , NDIS ruft NetAllocateMdl auf, um eine MDL und Arbeitsspeicher zuzuweisen.

NDIS gibt die Größe des zugeordneten Speicherblocks unter BufferSize an.

NetAllocateMdl kann jede Zuordnungsmethode verwenden, die die Entwurfsanforderungen des Treibers erfüllt. Wenn NDIS die NetFreeMdl-Funktion aufruft, um den Arbeitsspeicher freizugeben, sollte der NDIS-Treiber den Arbeitsspeicher freigeben, indem er denselben Speicherverwaltungsmechanismus verwendet, der zum Zuweisen des Arbeitsspeichers verwendet wurde.

NDIS ruft NetAllocateMdl unter IRQL <= DISPATCH_LEVEL auf.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Unterstützt in NDIS 6.0 und höher.
Kopfzeile	nblapi.h (include ndis.h)
IRQL	<= DISPATCH_LEVEL

Weitere Informationen

NdisRetreatNetBufferDataStart

NetFreeMdl