NDIS_SCATTER_GATHER_LIST_PARAMETERS Struktur (ndis.h)

Artikel
02/26/2024

Die NDIS_SCATTER_GATHER_LIST_PARAMETERS-Struktur gibt Parameter an, die NDIS verwendet, um eine Punkt-/Sammlungsliste für einen Puffer zu erstellen.

Syntax

typedef struct _NDIS_SCATTER_GATHER_LIST_PARAMETERS {
  NDIS_OBJECT_HEADER           Header;
  ULONG                        Flags;
  NDIS_RECEIVE_QUEUE_ID        QueueId;
  NDIS_SHARED_MEMORY_USAGE     SharedMemoryUsage;
  PMDL                         Mdl;
  PVOID                        CurrentVa;
  ULONG                        Length;
  NDIS_PROCESS_SG_LIST_HANDLER ProcessSGListHandler;
  PVOID                        Context;
  PSCATTER_GATHER_LIST         ScatterGatherListBuffer;
  ULONG                        ScatterGatherListBufferSize;
  ULONG                        ScatterGatherListBufferSizeNeeded;
} NDIS_SCATTER_GATHER_LIST_PARAMETERS, *PNDIS_SCATTER_GATHER_LIST_PARAMETERS;

Member

Header

Die NDIS_OBJECT_HEADER Struktur für die Struktur (NDIS_SCATTER_GATHER_LIST_PARAMETERS). Der Treiber legt das Type-Element der Struktur fest, das Header für NDIS_OBJECT_TYPE_DEFAULT, das Revisionselement auf NDIS_SCATTER_GATHER_LIST_PARAMETERS_REVISION_1 und das Size-Element auf NDIS_SIZEOF_SCATTER_GATHER_LIST_PARAMETERS_REVISION_1.

Flags

Reserviert für NDIS.

QueueId

Ein NDIS_RECEIVE_QUEUE_ID Typwert, der einen Warteschlangenbezeichner enthält. Der Warteschlangenbezeichner ist eine ganze Zahl zwischen null und der Anzahl von Warteschlangen, die der Miniportadapter unterstützt. Ein Nullwert gibt die Standardwarteschlange an.

SharedMemoryUsage

Ein NDIS_SHARED_MEMORY_USAGE Enumerationswert, der den Zweck des freigegebenen Arbeitsspeichers angibt.

Mdl

Ein Zeiger auf eine Speicherdeskriptorliste (Memory Descriptor List, MDL), die den freigegebenen Speicherpuffer beschreibt.

CurrentVa

Ein ULONG-Wert für die aktuelle virtuelle Adresse.

Length

Ein ULONG-Wert, der die Länge des Freigegebenen Speicherpuffers in Bytes enthält.

ProcessSGListHandler

Ein Zeiger auf eine NetProcessSGList-Funktion (NDIS_PROCESS_SG_LIST_HANDLER Einstiegspunkt).

Context

Ein Zeiger auf einen Block mit vom Treiber zugewiesenen Kontextinformationen, in dem Informationen zur Scatter-/Gather-Liste gespeichert werden. NDIS übergibt die Kontextinformationen in Aufrufen von NetProcessSGList am Context-Parameter .

ScatterGatherListBuffer

Ein Zeiger auf eine SCATTER_GATHER_LIST-Struktur .

ScatterGatherListBufferSize

Ein ULONG-Wert, der die Länge der Scatter/Gather-Liste in Bytes enthält.

ScatterGatherListBufferSizeNeeded

Ein ULONG-Wert, bei dem NDIS die Gesamtanzahl von Bytes schreibt, die NDIS benötigt, um die Scatter/Gather-Liste erfolgreich zu erstellen.

Hinweise

Um eine Scatter/Gather-Liste zu erstellen, übergibt ein NDIS-Treiber die NDIS_SCATTER_GATHER_LIST_PARAMETERS-Struktur an die NdisBuildScatterGatherList-Funktion .