structure NDIS_SCATTER_GATHER_LIST_PARAMETERS (ndis.h)

Article
02/29/2024

La structure NDIS_SCATTER_GATHER_LIST_PARAMETERS spécifie les paramètres utilisés par NDIS pour créer une liste de points/regroupements 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 la structure que l’en-tête spécifie sur NDIS_OBJECT_TYPE_DEFAULT, le membre Revision sur NDIS_SCATTER_GATHER_LIST_PARAMETERS_REVISION_1 et le membre Size sur 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 zéro indique la file d’attente par défaut.

SharedMemoryUsage

Une 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 partagée.

CurrentVa

Valeur ULONG pour l’adresse virtuelle actuelle.

Length

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

ProcessSGListHandler

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

Context

Pointeur vers un bloc d’informations de contexte allouées par le pilote qui stocke des informations sur la liste de points/regroupements. 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 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 points/regroupements.

Remarques

Pour créer une liste de points/regroupements, un pilote NDIS transmet la structure NDIS_SCATTER_GATHER_LIST_PARAMETERS au Fonction NdisBuildScatterGatherList .