NET_BUFFER_LIST Structure

Une structure NET_BUFFER_LIST empaquette une liste liée de structures NET_BUFFER.

La figure suivante montre les champs d’une structure NET_BUFFER_LIST.

La structure NET_BUFFER_LIST inclut une structure NET_BUFFER_LIST_HEADER dans le membre NetBufferListHeader. La structure NET_BUFFER_LIST_HEADER inclut une structure NET_BUFFER_LIST_DATA dans le membre NetBufferListData. Vous devez utiliser des macros NDIS pour accéder à NET_BUFFER_LIST membres de la structure. Pour plus d’informations sur ces macros, consultez la page de référence de structure NET_BUFFER_LIST.

Certains des membres sont utilisés uniquement par NDIS. Les membres que les pilotes sont les plus susceptibles d’utiliser sont définis dans la liste suivante :

ParentNetBufferList
Si une structure NET_BUFFER_LIST est un enfant dérivé d’un parent (cloné, fragmenté ou réassemble), ParentNetBufferList spécifie un pointeur vers la structure NET_BUFFER_LIST parent. Sinon, ce paramètre est NULL .

NdisPoolHandle
Spécifie un handle de pool qui identifie le pool NET_BUFFER_LIST à partir duquel la structure NET_BUFFER_LIST a été allouée.

protocol réservé
Réservé pour une utilisation par les pilotes de protocole.

MiniportReserved
Réservé à l’utilisation par les pilotes miniports.

SourceHandle
Handle fourni par NDIS au pilote dans une opération de liaison ou d’attachement à l’aide de l’une des routines fournies par le pilote suivantes :

Miniport Driver
MiniportInitializeEx

pilote de protocole
ProtocolBindAdapterEx

pilote de filtre
FilterAttach

NDIS utilise SourceHandle pour renvoyer la structure NET_BUFFER_LIST au pilote qui a envoyé la structure NET_BUFFER_LIST. Les pilotes NDIS ne doivent pas lire ce handle.

ChildRefCount
Si une structure NET_BUFFER_LIST est un parent (a des enfants dérivés par des opérations clone, fragment ou réassemble), ChildRefCount spécifie le nombre d’enfants existants. Sinon, ce paramètre est égal à zéro.

indicateurs
Réservé à la spécification future des attributs pour la structure NET_BUFFER_LIST. Il n’existe actuellement aucun indicateur disponible pour les pilotes.

d’état
Spécifie l’état final d’achèvement d’une opération de données réseau pour cette structure NET_BUFFER_LIST. Les pilotes miniport écrivent cette valeur avant d’effectuer une opération d’envoi.

NetBufferListInfo
Spécifie NET_BUFFER_LIST informations de structure communes à toutes les structures NET_BUFFER de la liste. Ces informations sont souvent appelées « données OOB (out-of-band). »

suivant
Spécifie un pointeur vers la structure de NET_BUFFER_LIST suivante dans une liste liée de structures NET_BUFFER_LIST. Si une structure NET_BUFFER_LIST est la dernière structure de la liste, ce membre est NULL.

FirstNetBuffer
Spécifie un pointeur vers la première structure de NET_BUFFER dans une liste liée de structures NET_BUFFER associées à cette structure NET_BUFFER_LIST.

Remarque de contexte est un pointeur vers une structure de NET_BUFFER_LIST_CONTEXT. NDIS fournit des macros et des fonctions pour manipuler les données à l'de contexte. Pour plus d’informations sur la structure NET_BUFFER_LIST_CONTEXT, consultez NET_BUFFER_LIST_CONTEXT Structure.