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 |