structure NDIS_SCATTER_GATHER_LIST_PARAMETERS (ndis.h)

Article
02/07/2025

La structure NDIS_SCATTER_GATHER_LIST_PARAMETERS spécifie les paramètres utilisés par NDIS pour générer une liste de nuages de points/collectes pour une mémoire tampon.

Syntaxe

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;

Membres

Header

Structure NDIS_OBJECT_HEADER de la structure (NDIS_SCATTER_GATHER_LIST_PARAMETERS). Le pilote définit le membre type de de la structure spécifiée par -en-tête à NDIS_OBJECT_TYPE_DEFAULT, le membre Révision à NDIS_SCATTER_GATHER_LIST_PARAMETERS_REVISION_1 et le membre Size à NDIS_SIZEOF_SCATTER_GATHER_LIST_PARAMETERS_REVISION_1.

Flags

Réservé à NDIS.

QueueId

Valeur de type NDIS_RECEIVE_QUEUE_ID qui contient un identificateur de file d’attente. L’identificateur de file d’attente est un entier compris entre zéro et le nombre de files d’attente pris en charge par l’adaptateur miniport. Une valeur nulle indique la file d’attente par défaut.

SharedMemoryUsage

Valeur d’énumération NDIS_SHARED_MEMORY_USAGE qui spécifie l’objectif de la mémoire partagée.

Mdl

Pointeur vers une liste de descripteurs de mémoire (MDL) qui décrit la mémoire tampon de mémoire partagée.

CurrentVa

Valeur ULONG pour l’adresse virtuelle actuelle.

Length

Valeur ULONG qui contient la longueur, en octets, de la mémoire tampon de mémoire partagée.

ProcessSGListHandler

Pointeur vers une fonction NetProcessSGList (point d’entrée NDIS_PROCESS_SG_LIST_HANDLER).

Context

Pointeur vers un bloc d’informations de contexte allouées par le pilote qui stocke des informations sur la liste de nuages de points/collectes. NDIS transmet les informations de contexte dans les appels à NetProcessSGList au paramètre Context.

ScatterGatherListBuffer

Pointeur vers une structure SCATTER_GATHER_LIST.

ScatterGatherListBufferSize

Valeur ULONG qui contient la longueur, en octets, de la liste de nuages de points/regroupements.

ScatterGatherListBufferSizeNeeded

Valeur ULONG dans laquelle NDIS écrit le nombre total d’octets requis par NDIS pour générer correctement la liste de nuages de points/regroupements.

Remarques

Pour générer une liste de points/regroupements, un pilote NDIS transmet la structure NDIS_SCATTER_GATHER_LIST_PARAMETERS à la fonction NdisBuildScatterGatherList.