énumération NDIS_NET_BUFFER_LIST_INFO (ndis/nblinfo.h)

Article
05/23/2024

L’énumération NDIS_NET_BUFFER_LIST_INFO identifie les informations communes à toutes les structures NET_BUFFER dans une structure NET_BUFFER_LIST.

Syntax

typedef enum _NDIS_NET_BUFFER_LIST_INFO {
  TcpIpChecksumNetBufferListInfo,
  TcpOffloadBytesTransferred,
  IPsecOffloadV1NetBufferListInfo,
  IPsecOffloadV2NetBufferListInfo,
  TcpLargeSendNetBufferListInfo,
  TcpReceiveNoPush,
  ClassificationHandleNetBufferListInfo,
  Ieee8021QNetBufferListInfo,
  NetBufferListCancelId,
  MediaSpecificInformation,
  NetBufferListFrameType,
  NetBufferListProtocolId,
  NetBufferListHashValue,
  NetBufferListHashInfo,
  WfpNetBufferListInfo,
  IPsecOffloadV2TunnelNetBufferListInfo,
  IPsecOffloadV2HeaderNetBufferListInfo,
  NetBufferListCorrelationId,
  NetBufferListFilteringInfo,
  MediaSpecificInformationEx,
  NblOriginalInterfaceIfIndex,
  NblReAuthWfpFlowContext,
  TcpReceiveBytesTransferred,
  NrtNameResolutionId,
  UdpRecvSegCoalesceOffloadInfo,
  SwitchForwardingReserved,
  SwitchForwardingDetail,
  VirtualSubnetInfo,
  IMReserved,
  TcpRecvSegCoalesceInfo,
  UdpSegmentationOffloadInfo,
  RscTcpTimestampDelta,
  TcpSendOffloadsSupplementalNetBufferListInfo,
  GftOffloadInformation,
  GftFlowEntryId,
  NetBufferListInfoReserved3,
  SwitchForwardingReserved,
  SwitchForwardingDetail_b0_to_b31,
  SwitchForwardingDetail_b32_to_b63,
  VirtualSubnetInfo,
  NetBufferListInfoReserved1,
  NetBufferListInfoReserved2,
  MaxNetBufferListInfo
} NDIS_NET_BUFFER_LIST_INFO, *PNDIS_NET_BUFFER_LIST_INFO;

Constantes


`TcpIpChecksumNetBufferListInfo` Identifie les informations de somme de contrôle utilisées dans le déchargement des tâches de somme de contrôle à partir du protocole TCP/IP à un pilote de miniport. Lorsque le répertoire TcpIpChecksumNetBufferListInfo est spécifié, la macro NET_BUFFER_LIST_INFO retourne un NDIS_TCP_IP_CHECKSUM_NET_BUFFER_LIST_INFO structure. Cette structure contient une union qui autorise les informations de somme de contrôle à accéder sous la forme d’une valeur PVOID unique ou de champs de bits.
`TcpOffloadBytesTransferred` Identifie une valeur ULONG qui correspond au nombre d’octets de données qui ont été transférés dans une cheminée TCP opération d’envoi, de réception ou de déconnexion de déchargement.
`IPsecOffloadV1NetBufferListInfo` Identifie les informations IPsec (Internet Protocol Security) utilisées dans le déchargement des tâches IPsec du protocole TCP/IP vers un pilote miniport. Lorsque le répertoire IPsecOffloadV1NetBufferListInfo est spécifié, NET_BUFFER_LIST_INFO retourne un NDIS_IPSEC_OFFLOAD_V1_NET_BUFFER_LIST_INFO structure.
`IPsecOffloadV2NetBufferListInfo` Spécifie les informations de déchargement de sécurité du protocole Internet version 2 (IPsecV2) utilisées dans déchargement des tâches IPsec du protocole TCP/IP vers un pilote miniport. Lorsque vous spécifiez IPsecOffloadV2NetBufferListInfo, NET_BUFFER_LIST_INFO retourne un NDIS_IPSEC_OFFLOAD_V2_NET_BUFFER_LIST_INFO structure.
`TcpLargeSendNetBufferListInfo` Identifie les informations utilisées pour décharger la segmentation d’un paquet TCP volumineux à partir du Protocole TCP/IP vers un adaptateur miniport pour le déchargement d’envoi de grande taille version 1 (LSOV1) et le déchargement d’envoi volumineux version 2 (LSOV2). Lorsque le répertoire TcpLargeSendNetBufferListInfo est spécifié, NET_BUFFER_LIST_INFO retourne un NDIS_TCP_LARGE_SEND_OFFLOAD_NET_BUFFER_LIST_INFO structure. Cette structure contient une union qui permet d’accéder aux informations sous la forme d’une valeur PVOID unique ou de champs de bits. Avant de transmettre un paquet TCP volumineux à un pilote miniport pour la segmentation, le protocole TCP/IP écrit les valeurs dans le Membre LsoV1Transmit du structure NDIS_TCP_LARGE_SEND_OFFLOAD_NET_BUFFER_LIST_INFO pour LSOV1 ou Membre LsoV2Transmit pour LSOV2. Avant de terminer l’envoi d’un paquet TCP volumineux qu’il a segmenté en paquets plus petits, un pilote miniport écrit les valeurs dans le Membre LsoV1TransmitComplete du NDIS_TCP_LARGE_SEND_OFFLOAD_NET_BUFFER_LIST_INFO structure pour LSOV1 ou le Membre LsoV2TransmitComplete pour LSOV2. Pour LSOV1, valeur que le pilote miniport écrit inclut le nombre total d’octets de charge utile TCP que le pilote miniport a envoyés dans les paquets qu’il a segmenté à partir du paquet TCP volumineux.
`TcpReceiveNoPush` Identifie une valeur booléenne qui représente le mode Push d’une demande de réception de déchargement de cheminée TCP. Si la valeur est TRUE, la demande de réception est en mode non push. Sinon, la demande de réception est en mode Push.
`ClassificationHandleNetBufferListInfo` Réservé.
`Ieee8021QNetBufferListInfo` Identifie les informations 802.1Q relatives à un paquet. Lorsque le répertoire Ieee8021QNetBufferListInfo est spécifié, NET_BUFFER_LIST_INFO retourne le Membre de valeur d’un NDIS_NET_BUFFER_LIST_8021Q_INFO structure. Cette structure peut spécifier la priorité 802.1p et le réseau local virtuel informations d’identificateur. Les informations de priorité 802.1p sont utilisées pour établir la priorité des paquets dans les médias partagés 802 réseaux. Les pilotes Miniport qui prennent en charge la balise 802.1Q dans le matériel doivent utiliser le NDIS_NET_BUFFER_LIST_8021Q_INFO structure pour les opérations de transmission et de réception.
`NetBufferListCancelId` Identifie une valeur ULONG_PTR qui est un identificateur d’annulation pour le NET_BUFFER_LIST structure. Pour annuler le en attente de transmission d’une structure NET_BUFFER_LIST marquée, un pilote de protocole passe le paquet identificateur d’annulation à NdisCancelSendNetBufferLists. Les pilotes doivent appeler NdisGeneratePartialCancelId pour obtenir une valeur que le pilote doit utiliser comme octet d’ordre élevé d’un identificateur d’annulation.
`MediaSpecificInformation` Identifie une valeur PVOID qui est l’adresse d’une mémoire tampon allouée par le pilote. Cette mémoire tampon contient toutes les données hors bande spécifiques d’un média qui accompagnent le NET_BUFFER structures associées à structure NET_BUFFER_LIST . Si un pilote de protocole a alloué les données hors bande, il a configuré le données pour une opération d’envoi. Si un pilote miniport a alloué les données, il a configuré les données pour une réception Indication.
`NetBufferListFrameType` Identifie une valeur USHORT qui est le type de trame des paquets Ethernet reçus.
`NetBufferListProtocolId` Identifie une valeur UCHAR qui est un identificateur de protocole comme l’une des valeurs suivantes : NDIS_PROTOCOL_ID_DEFAULT Identificateur de pilote de protocole par défaut. NDIS_PROTOCOL_ID_TCP_IP Protocole TCP/IP. NDIS_PROTOCOL_ID_IPX Protocole IPX. NDIS_PROTOCOL_ID_NBF Protocole NetBEUI.
`NetBufferListHashValue` Sur le chemin de réception, NetBufferListHashValue identifie une valeur ULONG qui est la valeur de hachage RSS calculée par une carte réseau. le cas échéant. Sur le chemin de transmission, NetBufferListHashValue identifie une valeur ULONG qui est la valeur de hachage RSS calculée par TCP/IP, le cas échéant. Dans ce cas, toutes les structures NET_BUFFER dans une structure NET_BUFFER_LIST que TCP/IP a envoyées appartiennent à la même connexion UDP ou TCP. Par conséquent, cette valeur de hachage s’applique à tous les NET_BUFFER structures qui se trouvent dans la structure NET_BUFFER_LIST . Pour plus d'informations, consultez la rubrique Indication de la réception RSS Données.
`NetBufferListHashInfo` Identifie une valeur ULONG qui est les informations de hachage RSS, qui incluent la fonction de hachage et Type de hachage. Pour plus d'informations, consultez la rubrique Indication de la réception RSS Données.
`WfpNetBufferListInfo` Réservé à l’utilisation par la plateforme de filtrage Windows (PAM). Aucun chauffeur, y compris la légende du PAM les pilotes, peuvent stocker des informations à l’aide de cette valeur.
`IPsecOffloadV2TunnelNetBufferListInfo` Spécifie les informations de tunnel IPsecV2 utilisées dans le déchargement des tâches IPsec à partir du protocole TCP/IP à un pilote miniport. Lorsque vous spécifiez IPsecOffloadV2TunnelNetBufferListInfo, NET_BUFFER_LIST_INFO retourne un NDIS_IPSEC_OFFLOAD_V2_TUNNEL_NET_BUFFER_LIST_INFO structure.
`IPsecOffloadV2HeaderNetBufferListInfo` Spécifie les informations d’en-tête IPsecV2 utilisées dans le déchargement des tâches IPsec à partir du protocole TCP/IP à un pilote miniport. Lorsque vous spécifiez IPsecOffloadV2HeaderNetBufferListInfo, NET_BUFFER_LIST_INFO retourne un NDIS_IPSEC_OFFLOAD_V2_HEADER_NET_BUFFER_LIST_INFO structure.
`NetBufferListCorrelationId` Réservé.
`NetBufferListFilteringInfo` Spécifie les informations de filtrage utilisées dans l’interface de file d’attente de machines virtuelles (VMQ), l’interface de virtualisation d’E/S racine unique (SR-IOV) et le regroupement de paquets NDIS. Lorsque vous spécifiez NetBufferListFilteringInfo, NET_BUFFER_LIST_INFO retourne un NDIS_NET_BUFFER_LIST_FILTERING_INFO structure. À compter de NDIS 6.20, les indications de réception effectuées par les pilotes miniport qui prennent en charge vmQ, SR-IOV ou le regroupement de paquets doivent inclure une structure NDIS_NET_BUFFER_LIST_FILTERING_INFO . Les pilotes miniport doivent définir l’identificateur de file d’attente VMQ dans le QueueId membre du NDIS_NET_BUFFER_LIST_FILTERING_INFO structure. Le pilote définit également le membre FilterId de la structure NDIS_NET_BUFFER_LIST_FILTERING_INFO sur zéro. Note À compter de NDIS 6.30, le pilote miniport qui prend en charge SR-IOV ou le regroupement de paquets doit définir queueId sur NDIS_DEFAULT_RECEIVE_QUEUE_ID et le membre FilterId sur zéro.
`MediaSpecificInformationEx` Identifie un pointeur vers un pilote alloué NDIS_NBL_MEDIA_SPECIFIC_INFORMATION_EX structure. Cette structure identifie tout média spécifique données hors bande qui accompagnent les structures NET_BUFFER associées au NET_BUFFER_LIST Structure. Les pilotes NDIS 6.20 et versions ultérieures doivent utiliser le structure NDIS_NBL_MEDIA_SPECIFIC_INFORMATION_EX pour spécifier des informations spécifiques au média. N’importe quel pilote d’une pile de pilotes NDIS peut allouer et gérer informations spécifiques aux médias.
`NblOriginalInterfaceIfIndex` Réservé.
`NblReAuthWfpFlowContext` Réservé.
`TcpReceiveBytesTransferred` Identifie une valeur ULONG qui correspond au nombre d’octets de données reçus par la pile hôte et a rempli la demande de réception qui est en cours de traitement en tant qu’opération de réception de déchargement de la cheminée TCP.
`NrtNameResolutionId` Réservé.
`UdpRecvSegCoalesceOffloadInfo` Identifie les informations de déchargement coalescing du segment de réception UDP (URO). Quand UdpRecvSegCoalesceOffloadInfo est spécifié, NET_BUFFER_LIST_INFO retourne une structure NDIS_UDP_RSC_OFFLOAD_NET_BUFFER_LIST_INFO . Cette structure contient une union qui permet aux pilotes d’accéder aux informations sous la forme d’une seule valeur PVOID.
`SwitchForwardingReserved` Réservé à NDIS.
`SwitchForwardingDetail` Identifie un pointeur vers une structure de NDIS_SWITCH_FORWARDING_DETAIL_NET_BUFFER_LIST_INFO allouée par un pilote. Cette structure spécifie les informations permettant de transférer un paquet vers un ou plusieurs ports d’un commutateur extensible Hyper-V. Le pilote alloue cette structure en appelant AllocateNetBufferListForwardingContext et libère la structure en appelant FreeNetBufferListForwardingContext.
`VirtualSubnetInfo` Identifie un pointeur vers une structure de NDIS_NET_BUFFER_LIST_VIRTUAL_SUBNET_INFO allouée par un pilote.
`IMReserved` Réservé à NDIS.
`TcpRecvSegCoalesceInfo` Identifie les informations de fusion des segments de réception (RSC). Lorsque TcpRecvSegCoalesceInfo est spécifié, NET_BUFFER_LIST_INFO retourne une union NDIS_RSC_NBL_INFO . Cette union permet aux pilotes d’accéder aux informations sous la forme d’une seule valeur PVOID.
`UdpSegmentationOffloadInfo` Identifie les informations utilisées dans le déchargement de la segmentation d’un paquet UDP volumineux du protocole TCP/IP vers un adaptateur miniport pour le déchargement de segmentation UDP (USO). Quand UdpSegmentationOffloadInfo est spécifié, NET_BUFFER_LIST_INFO retourne une structure NDIS_UDP_SEGMENTATION_OFFLOAD_NET_BUFFER_LIST_INFO . Cette structure contient une union qui permet aux pilotes d’accéder aux informations sous la forme d’une valeur PVOID unique ou de champs de bits.
`RscTcpTimestampDelta` Identifie une valeur ULONG contenant des informations d’horodatage RSC. Pour plus d’informations, consultez la documentation NDIS_RSC_NBL_INFO .
`TcpSendOffloadsSupplementalNetBufferListInfo` Identifie un pointeur vers une structure de NDIS_TCP_SEND_OFFLOADS_SUPPLEMENTAL_NET_BUFFER_LIST_INFO allouée par un pilote contenant des informations supplémentaires hors bande pour les paquets encapsulés.
`GftOffloadInformation` Informations de déchargement de la table de flux générique (GFT).
`GftFlowEntryId` ID d’entrée de flux pour GFT.
`NetBufferListInfoReserved3` Réservé.
`SwitchForwardingReserved` Réservé à NDIS.
`SwitchForwardingDetail_b0_to_b31` Identifie un pointeur vers une structure de NDIS_SWITCH_FORWARDING_DETAIL_NET_BUFFER_LIST_INFO allouée par un pilote. SwitchForwardingDetail_b0_to_b31 et SwitchForwardingDetail_b32_to_b63 sont utilisés pour ajuster les données OOB 64b pour le mode 32b. Disponible dans NDIS 6.82 et versions ultérieures.
`SwitchForwardingDetail_b32_to_b63` Voir SwitchForwardingDetail_b0_to_b31.
`VirtualSubnetInfo` Identifie un pointeur vers une structure de NDIS_NET_BUFFER_LIST_VIRTUAL_SUBNET_INFO allouée par un pilote.
`NetBufferListInfoReserved1` Réservé à NDIS.
`NetBufferListInfoReserved2` Réservé à NDIS.
`MaxNetBufferListInfo` Valeur maximale pour cette énumération. Cette valeur peut changer dans les versions ultérieures des fichiers d’en-tête NDIS et des fichiers binaires.

Remarques

L’énumération NDIS_NET_BUFFER_LIST_INFO est utilisée dans la structure NET_BUFFER_LIST.

Utilisez ces valeurs d’énumération avec la macro NET_BUFFER_LIST_INFO pour définir et obtenir des valeurs dans le tableau NetBufferListInfo dans un NET_BUFFER_LIST.