structure NDIS_SCATTER_GATHER_LIST_PARAMETERS (ndis.h)
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.
Exigences
Exigence | Valeur |
---|---|
client minimum pris en charge | Pris en charge dans NDIS 6.20 et versions ultérieures. |
d’en-tête | ndis.h (include Ndis.h) |