NET_BUFFER_LIST Structure
Une structure NET_BUFFER_LIST regroupe 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 qui a été dérivé d’un parent (cloné, fragmenté ou réassemblé), ParentNetBufferList spécifie un pointeur vers la structure parente NET_BUFFER_LIST. 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.
ProtocolReserved
Réservé à une utilisation par les pilotes de protocole.
MiniportReserved
Réservé à l’utilisation par les pilotes de miniport.
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 :
Pilote miniport
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 de clonage, de fragment ou de réassemblage), ChildRefCount spécifie le nombre d’enfants existants. Sinon, ce paramètre est égal à zéro.
Drapeaux
Réservé pour la spécification future des attributs pour la structure NET_BUFFER_LIST. Aucun indicateur n’est actuellement disponible pour les pilotes.
État
Spécifie la status d’achèvement finale d’une opération de données réseau pour cette structure de 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 hors bande (OOB). »
Prochain
Spécifie un pointeur vers la structure 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 NET_BUFFER dans une liste liée de structures NET_BUFFER associées à cette structure NET_BUFFER_LIST.
Remarque Context est un pointeur vers une structure NET_BUFFER_LIST_CONTEXT. NDIS fournit des macros et des fonctions pour manipuler les données dans Context . Pour plus d’informations sur la structure NET_BUFFER_LIST_CONTEXT, consultez structure NET_BUFFER_LIST_CONTEXT.