NdisBuildScatterGatherList-Funktion (ndis.h)

Artikel
03/01/2024

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

Syntax

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

Parameter

[in] NdisHandle

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

NdisRegisterProtocolDriver

NdisOpenAdapterEx

[in] SGListParameters

Ein Zeiger auf eine NDIS_SCATTER_GATHER_LIST_PARAMETERS Struktur, die die Parameter für die Zuweisung der Punkt-/Sammlungsliste angibt.

Rückgabewert

NdisBuildScatterGatherList kann die folgenden status Werte zurückgeben:

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

Hinweise

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

Der zugrunde liegende Miniportadapter muss aufgerufen haben. NdisMRegisterScatterGatherDma , bevor ein Treiber NdisBuildScatterGatherList aufrufen kann.

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

Die Treiber müssen das -Element aufrufen. NdisFreeScatterGatherList-Funktion zum Freigeben einer Scatter-/Gather-Liste, die mit der erstellt wurde NdisBuildScatterGatherList-Funktion .

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Unterstützt in NDIS 6.20 und höher.
Zielplattform	Universell
Header	ndis.h (include Ndis.h)
Bibliothek	Ndis.lib
IRQL	= DISPATCH_LEVEL