NdisBuildScatterGatherList-Funktion (ndis.h)

Artikel
02/07/2025

Die NdisBuildScatterGatherList Funktion erstellt eine Punkt-/Gather-Liste mithilfe der angegebenen Parameter.

Syntax

NDIS_STATUS NdisBuildScatterGatherList(
  [in] IN NDIS_HANDLE                          NdisHandle,
  [in] IN PNDIS_SCATTER_GATHER_LIST_PARAMETERS SGListParameters
);

Parameter

[in] NdisHandle

Ein NDIS-Treiber oder Instanzhandle, das während der Initialisierung des Aufrufers abgerufen wurde. Beispielsweise kann ein Miniporttreiber den NDIS-Handle verwenden, den er aus dem NdisMRegisterMiniportDriver oder MiniportInitializeEx Funktion. Andere NDIS-Treiber können die Handles aus den folgenden Funktionen verwenden:

NdisRegisterProtocolDriver-

NdisOpenAdapterEx

[in] SGListParameters

Ein Zeiger auf einen NDIS_SCATTER_GATHER_LIST_PARAMETERS Struktur, die die Parameter zum Zuordnen der Punkt/Gather-Liste angibt.

Rückgabewert

NdisBuildScatterGatherList- können die folgenden Statuswerte zurückgeben:

Rückgabecode	Beschreibung
NDIS_STATUS_SUCCESS	Der Vorgang wurde erfolgreich abgeschlossen.
NDIS_STATUS_BUFFER_TOO_SHORT	Fehler beim Vorgang, da die Pufferlänge, die im ScatterGatherListBufferSize-Element angegeben ist, Member des NDIS_SCATTER_GATHER_LIST_PARAMETERS Struktur war zu kurz. In diesem Fall hat NDIS die erforderliche Puffergröße im ScatterGatherListBufferSizeNeeded Member bereitgestellt.

Bemerkungen

NDIS-Treiber rufen die NdisBuildScatterGatherList-Funktion auf, um eine Punkt/Gather-Liste für einen Puffer zu erstellen. Um diese Funktion aufzurufen, gibt ein Miniporttreiber einen Miniportadapterhandle oder einen Protokolltreiber an, der ein NDIS-Bindungshandle angibt.

Der zugrunde liegende Miniportadapter muss aufgerufen werden. NdisMRegisterScatterGatherDma, bevor ein Treiber NdisBuildScatterGatherListaufrufen kann.

NDIS ruft die NetProcessSGList--Funktion auf, die im ProcessSGListHandler Member des NDIS_SCATTER_GATHER_LIST_PARAMETERS Struktur im Kontext von NdisBuildScatterGatherList.

Die Treiber müssen die NdisFreeScatterGatherList--Funktion, um eine XY/Gather-Liste freizulösen, die mit der NdisBuildScatterGatherList Funktion.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Unterstützt in NDIS 6.20 und höher.
Zielplattform-	Universal
Header-	ndis.h (include Ndis.h)
Library	Ndis.lib
IRQL-	= DISPATCH_LEVEL