NdisAllocateCloneNetBufferList-Funktion (ndis/nblapi.h)

Artikel
02/26/2024

Rufen Sie die Funktion NdisAllocateCloneNetBufferList auf, um einen neuen Klon NET_BUFFER_LIST Struktur zu erstellen.

Syntax

NDIS_EXPORTED_ROUTINE NET_BUFFER_LIST * NdisAllocateCloneNetBufferList(
  [in]           NET_BUFFER_LIST *OriginalNetBufferList,
  [in, optional] NDIS_HANDLE     NetBufferListPoolHandle,
  [in, optional] NDIS_HANDLE     NetBufferPoolHandle,
  [in]           ULONG           AllocateCloneFlags
);

Parameter

[in] OriginalNetBufferList

Ein Zeiger auf eine vorhandene NET_BUFFER_LIST-Struktur .

[in, optional] NetBufferListPoolHandle

Ein Handle, das von einem Aufruf des abgerufen wurde NdisAllocateNetBufferListPool-Funktion .

[in, optional] NetBufferPoolHandle

Ein NET_BUFFER Strukturpoolhandle, das zuvor von einem Aufruf von zurückgegeben wurde NdisAllocateNetBufferPool.

[in] AllocateCloneFlags

NDIS-Flags, die mit einem OR-Vorgang kombiniert werden können. Die folgenden Flags sind definiert:

NDIS_CLONE_FLAGS_RESERVED

Reserviert für NDIS.

NDIS_CLONE_FLAGS_USE_ORIGINAL_MDLS

Wenn dieses Flag festgelegt ist, ordnet NDIS keine neuen MDLs für die geklonte NET_BUFFER_LIST zu. Stattdessen verwendet die geklonte NET_BUFFER_LIST dieselbe MDL-Kette wie die ursprüngliche NET_BUFFER_LIST. Wenn NDIS_CLONE_FLAGS_USE_ORIGINAL_MDLS gelöscht wird, ordnet NDIS neue MDLs zu, um auf die ursprünglichen Datenpuffer zu verweisen.

Rückgabewert

NdisAllocateCloneNetBufferList gibt einen Zeiger auf die neue Klonstruktur NET_BUFFER_LIST zurück. Wenn die Zuordnung nicht erfolgreich war, ist dieser Zeiger NULL.

Hinweise

Rufen Sie NdisAllocateCloneNetBufferList auf, um einen Klon NET_BUFFER_LIST Struktur zu erstellen, mit der Sie doppelte Daten über einen separaten Datenpfad senden können.

Jede NET_BUFFER-Struktur in der ursprünglichen NET_BUFFER_LIST-Struktur wird nur vom Anfang des verwendeten Datenbereichs geklont, nicht vom Anfang des gesamten Datenbereichs. Verwenden Sie das Makro NET_BUFFER_DATA_OFFSET , um den Offset vom Anfang des Datenbereichs bis zum Anfang des verwendeten Datenbereichs abzurufen.

Wenn die geklonte NET_BUFFER_LIST-Struktur Attribute aufweisen soll, die einem bestimmten Pool zugeordnet sind, muss der Aufrufer das Poolhandle im Parameter NetBufferListPoolHandle oder NetBufferPoolHandle angeben. Beispielsweise ist der ProtocolType-Member der NET_BUFFER_LIST-Struktur dem Pool zugeordnet.

Die Klon-NET_BUFFER_LIST-Struktur beschreibt die gleichen Daten, die in der NET_BUFFER_LIST-Struktur unter OriginalNetBufferList beschrieben werden. NDIS kopiert die Daten, die von den ursprünglichen MDLs beschrieben werden, nicht in neue Datenpuffer. Stattdessen verweisen die geklonten Strukturen auf die ursprünglichen Datenpuffer. Die Klon-NET_BUFFER_LIST-Struktur enthält keine anfängliche NET_BUFFER_LIST_CONTEXT Struktur.

Rufen Sie die folgenden NdisFreeCloneNetBufferList-Funktion , um eine NET_BUFFER_LIST-Struktur und alle zugeordneten Strukturen und MDL-Ketten frei zu geben, die durch Aufrufen von NdisAllocateCloneNetBufferList zugeordnet wurden.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Unterstützt in NDIS 6.0 und höher.
Zielplattform	Universell
Header	ndis/nblapi.h (include ndis.h)
Bibliothek	Ndis.lib
IRQL	<= DISPATCH_LEVEL
DDI-Complianceregeln	Irql_NetBuffer_Function(ndis), NdisAllocateCloneNetBufferList(ndis), NdisAllocateCloneNetBufferList_InitFail(ndis)