NDIS_NET_BUFFER_LIST_INFO-Enumeration (ndis/nblinfo.h)

Artikel
05/23/2024

Die NDIS_NET_BUFFER_LIST_INFO-Enumeration identifiziert Informationen, die allen NET_BUFFER-Strukturen in einer NET_BUFFER_LIST-Struktur gemeinsam sind.

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;

Konstanten


`TcpIpChecksumNetBufferListInfo` Identifiziert Prüfsummeninformationen, die beim Auslagern von Prüfsummentasks aus dem TCP/IP-Protokoll verwendet werden. an einen Miniporttreiber. When TcpIpChecksumNetBufferListInfo wird angegeben, das NET_BUFFER_LIST_INFO Makro gibt einen NDIS_TCP_IP_CHECKSUM_NET_BUFFER_LIST_INFO Struktur. Diese Struktur enthält eine Union, die die Prüfsummeninformationen, auf die als einzelner PVOID-Wert oder als Bitfelder zugegriffen werden soll.
`TcpOffloadBytesTransferred` Identifiziert einen ULONG-Wert , der die Anzahl der Datenbytes angibt, die in einem TCP-Schornstein übertragen wurden. Offload-Vorgang zum Senden, Empfangen oder Trennen.
`IPsecOffloadV1NetBufferListInfo` Identifiziert IPsec-Informationen (Internet Protocol Security, Internetprotokollsicherheit), die beim Auslagern von IPsec-Aufgaben verwendet werden vom TCP/IP-Protokoll zu einem Miniporttreiber. When IPsecOffloadV1NetBufferListInfo wird angegeben, NET_BUFFER_LIST_INFO gibt einen NDIS_IPSEC_OFFLOAD_V1_NET_BUFFER_LIST_INFO Struktur.
`IPsecOffloadV2NetBufferListInfo` Gibt Informationen zur Internetprotokollsicherheitsauslagerung version 2 (IPsecV2) an, die in verwendet werden. Auslagerung von IPsec-Aufgaben aus dem TCP/IP-Protokoll in einen Miniporttreiber. Wenn Sie angeben IPsecOffloadV2NetBufferListInfo, NET_BUFFER_LIST_INFO gibt zurück NDIS_IPSEC_OFFLOAD_V2_NET_BUFFER_LIST_INFO Struktur.
`TcpLargeSendNetBufferListInfo` Identifiziert Informationen, die beim Auslagern der Segmentierung eines großen TCP-Pakets aus dem TCP/IP-Protokoll an einen Miniportadapter für große Sendeauslagerung Version 1 (LSOV1) und große Sendeauslagerung Version 2 (LSOV2). When TcpLargeSendNetBufferListInfo wird angegeben, NET_BUFFER_LIST_INFO gibt eine NDIS_TCP_LARGE_SEND_OFFLOAD_NET_BUFFER_LIST_INFO Struktur. Diese Struktur enthält eine Union, die ermöglicht den Zugriff auf die Informationen als einzelner PVOID-Wert oder als Bitfelder. Bevor ein großes TCP-Paket zur Segmentierung an einen Miniporttreiber übergeben wird, schreibt das TCP/IP-Protokoll die Werte in der LsoV1Transmit-Element des NDIS_TCP_LARGE_SEND_OFFLOAD_NET_BUFFER_LIST_INFO Struktur für LSOV1 oder LsoV2Transmit-Member für LSOV2. Vor abschluss des Sendens eines großen TCP-Pakets, über das es verfügt segmentiert in kleinere Pakete, schreibt ein Miniporttreiber die Werte in die LsoV1TransmitComplete-Element des NDIS_TCP_LARGE_SEND_OFFLOAD_NET_BUFFER_LIST_INFO-Struktur für LSOV1 oder die LsoV2TransmitComplete-Member für LSOV2. Für LSOV1: der Wert, den der Miniporttreiber schreibt. enthält die Gesamtzahl der TCP-Nutzlastbytes, die der Miniporttreiber in den Paketen gesendet hat, die er gesendet hat. segmentiert aus dem großen TCP-Paket.
`TcpReceiveNoPush` Gibt einen booleschen Wert an, der den Pushmodus einer TCP-Schornsteinabladungs-Empfangsanforderung darstellt. True gibt an, dass sich die Empfangsanforderung im Nicht-Push-Modus befindet. Andernfalls befindet sich die Empfangsanforderung im Pushmodus.
`ClassificationHandleNetBufferListInfo` Reserviert.
`Ieee8021QNetBufferListInfo` Identifiziert 802.1Q-Informationen zu einem Paket. When Ieee8021QNetBufferListInfo ist angegeben, NET_BUFFER_LIST_INFO gibt die Wertmember eines NDIS_NET_BUFFER_LIST_8021Q_INFO Struktur. Diese Struktur kann die 802.1p-Priorität und das VLAN angeben. Bezeichnerinformationen. 802.1p-Prioritätsinformationen werden verwendet, um die Paketpriorität in shared-media festzulegen. 802-Netze. Miniport-Treiber, die das 802.1Q-Tag in Hardware unterstützen, müssen die NDIS_NET_BUFFER_LIST_8021Q_INFO Struktur für Übertragungs- und Empfangsvorgänge.
`NetBufferListCancelId` Identifiziert einen ULONG_PTR Wert, der ein Abbruchbezeichner für die NET_BUFFER_LIST Struktur. So brechen Sie die Wenn die Übertragung einer markierten NET_BUFFER_LIST-Struktur aussteht, übergibt ein Protokolltreiber die des Pakets. Abbruchbezeichner für NdisCancelSendNetBufferLists. Treiber müssen aufrufen NdisGeneratePartialCancelId , um einen Wert zu erhalten, den der Treiber als hochgeordnetes Byte eines verwenden muss Abbruchbezeichner.
`MediaSpecificInformation` Gibt einen PVOID-Wert an, der die Adresse eines vom Treiber zugewiesenen Puffers ist. Dieser Puffer enthält alle medienspezifischen Out-of-Band-Daten, die der NET_BUFFER Strukturen, die zugeordnet sind die NET_BUFFER_LIST-Struktur . Wenn ein Protokolltreiber die Out-of-Band-Daten zugeordnet hat, konfiguriert er die Daten für einen Sendevorgang. Wenn ein Miniporttreiber die Daten zugeordnet hat, hat er die Daten für einen Empfang konfiguriert. Angabe.
`NetBufferListFrameType` Gibt einen USHORT-Wert an, der dem Frametyp der empfangenen Ethernet-Pakete entspricht.
`NetBufferListProtocolId` Identifiziert einen UCHAR-Wert , der ein Protokollbezeichner ist, als einen der folgenden Werte: NDIS_PROTOCOL_ID_DEFAULT Ein Standardprotokolltreiberbezeichner. NDIS_PROTOCOL_ID_TCP_IP Das TCP/IP-Protokoll. NDIS_PROTOCOL_ID_IPX Das IPX-Protokoll. NDIS_PROTOCOL_ID_NBF Das NetBEUI-Protokoll.
`NetBufferListHashValue` Gehen Sie im Empfangspfad wie NetBufferListHashValue identifiziert einen ULONG-Wert , bei dem es sich um den RSS-Hashwert handelt, den eine NIC berechnet hat. falls vorhanden. Auf dem Übertragungspfad NetBufferListHashValue identifiziert einen ULONG-Wert , bei dem es sich um den RSS-Hashwert handelt, den TCP/IP berechnet hat. falls vorhanden. In diesem Fall alle NET_BUFFER Strukturen in einer NET_BUFFER_LIST Struktur, die TCP/IP übermittelt hat gehören zur gleichen UDP- oder TCP-Verbindung. Daher gilt dieser Hashwert für alle NET_BUFFER Strukturen, die sich in der NET_BUFFER_LIST-Struktur befinden. Weitere Informationen finden Sie unter Anzeigen des RSS-Empfangs Daten.
`NetBufferListHashInfo` Identifiziert einen ULONG-Wert , bei dem es sich um die RSS-Hashinformationen handelt, die die Hashfunktion und Hashtyp. Weitere Informationen finden Sie unter Anzeigen des RSS-Empfangs Daten.
`WfpNetBufferListInfo` Reserviert für die Verwendung durch die Windows-Filterplattform (WFP). Keine Treiber, einschließlich WFP-Beschriftung Treiber, können Informationen mit diesem Wert speichern.
`IPsecOffloadV2TunnelNetBufferListInfo` Gibt IPsecV2-Tunnelinformationen an, die beim Auslagern von IPsec-Tasks aus dem TCP/IP-Protokoll verwendet werden. an einen Miniporttreiber. Wenn Sie angeben IPsecOffloadV2TunnelNetBufferListInfo, NET_BUFFER_LIST_INFO gibt eine zurück NDIS_IPSEC_OFFLOAD_V2_TUNNEL_NET_BUFFER_LIST_INFO Struktur.
`IPsecOffloadV2HeaderNetBufferListInfo` Gibt IPsecV2-Headerinformationen an, die beim Auslagern von IPsec-Aufgaben aus dem TCP/IP-Protokoll verwendet werden. an einen Miniporttreiber. Wenn Sie IPsecOffloadV2HeaderNetBufferListInfo angeben, gibt NET_BUFFER_LIST_INFO einen NDIS_IPSEC_OFFLOAD_V2_HEADER_NET_BUFFER_LIST_INFO Struktur.
`NetBufferListCorrelationId` Reserviert.
`NetBufferListFilteringInfo` Gibt Filterinformationen an, die in der VMQ-Schnittstelle (VMQ), der Single Root-E/A-Virtualisierungsschnittstelle (SR-IOV) und der NDIS-Paketverknöhnung verwendet werden. Wenn Sie angeben NetBufferListFilteringInfo, NET_BUFFER_LIST_INFO einen zurückgibt NDIS_NET_BUFFER_LIST_FILTERING_INFO Struktur. Ab NDIS 6.20 erhalten Sie Hinweise von Miniporttreibern, die VMQ, SR-IOV oder Paketkopplung unterstützen, eine NDIS_NET_BUFFER_LIST_FILTERING_INFO-Struktur enthalten. Die Miniporttreiber müssen den VMQ-Warteschlangenbezeichner im QueueId-Member des NDIS_NET_BUFFER_LIST_FILTERING_INFO Struktur. Der Treiber legt auch das FilterId-Element der NDIS_NET_BUFFER_LIST_FILTERING_INFO-Struktur auf 0 fest. Hinweis Ab NDIS 6.30 muss der Miniporttreiber, der SR-IOV- oder Paketkopplung unterstützt, die QueueId auf NDIS_DEFAULT_RECEIVE_QUEUE_ID und den FilterId-Member auf 0 festlegen.
`MediaSpecificInformationEx` Identifiziert einen Zeiger auf einen vom Treiber zugewiesenen NDIS_NBL_MEDIA_SPECIFIC_INFORMATION_EX Struktur. Diese Struktur identifiziert alle medienspezifischen Out-of-Band-Daten, die die NET_BUFFER Strukturen begleiten, die dem NET_BUFFER_LIST Struktur. NDIS 6.20 und höher sollten die NDIS_NBL_MEDIA_SPECIFIC_INFORMATION_EX Struktur , um medienspezifische Informationen anzugeben. Jeder Treiber in einem NDIS-Treiberstapel kann zuordnen und verwalten medienspezifische Informationen.
`NblOriginalInterfaceIfIndex` Reserviert.
`NblReAuthWfpFlowContext` Reserviert.
`TcpReceiveBytesTransferred` Gibt einen ULONG-Wert an, der die Anzahl von Datenbytes entspricht, die vom Hoststapel empfangen wurden. füllen Sie die Empfangsanforderung ein, die als TCP-Schornsteinabladungsvorgang verarbeitet wird.
`NrtNameResolutionId` Reserviert.
`UdpRecvSegCoalesceOffloadInfo` Identifiziert UDP Receive Segment Coalescing Offload-Informationen (URO). Wenn UdpRecvSegCoalesceOffloadInfo angegeben wird, gibt NET_BUFFER_LIST_INFO eine NDIS_UDP_RSC_OFFLOAD_NET_BUFFER_LIST_INFO-Struktur zurück. Diese Struktur enthält eine Union, die es Treibern ermöglicht, als einzelner PVOID-Wert auf die Informationen zuzugreifen.
`SwitchForwardingReserved` Reserviert für NDIS.
`SwitchForwardingDetail` Identifiziert einen Zeiger auf eine vom Treiber zugewiesene NDIS_SWITCH_FORWARDING_DETAIL_NET_BUFFER_LIST_INFO-Struktur . Diese Struktur gibt die Informationen zum Weiterleiten eines Pakets an einen oder mehrere Ports eines erweiterbaren Hyper-V-Switches an. Der Treiber weist diese Struktur zu, indem er AllocateNetBufferListForwardingContext aufruft und die Struktur durch Aufruf von FreeNetBufferListForwardingContext freigibt.
`VirtualSubnetInfo` Gibt einen Zeiger auf eine vom Treiber zugewiesene NDIS_NET_BUFFER_LIST_VIRTUAL_SUBNET_INFO-Struktur an.
`IMReserved` Reserviert für NDIS.
`TcpRecvSegCoalesceInfo` Identifiziert RSC-Informationen (Receive Segment Coalescing). Wenn TcpRecvSegCoalesceInfo angegeben wird, gibt NET_BUFFER_LIST_INFO eine NDIS_RSC_NBL_INFO Union zurück. Diese Vereinigung ermöglicht es Treibern, auf die Informationen als einzelnen PVOID-Wert zuzugreifen.
`UdpSegmentationOffloadInfo` Identifiziert Informationen, die beim Auslagern der Segmentierung eines großen UDP-Pakets aus dem TCP/IP-Protokoll auf einen Miniportadapter für udp Segmentation Offload (USO) verwendet werden. Wenn UdpSegmentationOffloadInfo angegeben wird, gibt NET_BUFFER_LIST_INFO eine NDIS_UDP_SEGMENTATION_OFFLOAD_NET_BUFFER_LIST_INFO-Struktur zurück. Diese Struktur enthält eine Union, die es Treibern ermöglicht, auf die Informationen als einzelnen PVOID-Wert oder als Bitfelder zuzugreifen.
`RscTcpTimestampDelta` Gibt einen ULONG-Wert an, der RSC-Zeitstempelinformationen enthält. Weitere Informationen finden Sie in der NDIS_RSC_NBL_INFO-Dokumentation .
`TcpSendOffloadsSupplementalNetBufferListInfo` Identifiziert einen Zeiger auf eine vom Treiber zugewiesene NDIS_TCP_SEND_OFFLOADS_SUPPLEMENTAL_NET_BUFFER_LIST_INFO-Struktur , die zusätzliche Out-of-Band-Informationen für gekapselte Pakete enthält.
`GftOffloadInformation` Generic Flow Table (GFT) Offload-Informationen.
`GftFlowEntryId` Die Floweintrags-ID für GFT.
`NetBufferListInfoReserved3` Reserviert.
`SwitchForwardingReserved` Reserviert für NDIS.
`SwitchForwardingDetail_b0_to_b31` Identifiziert einen Zeiger auf eine vom Treiber zugewiesene NDIS_SWITCH_FORWARDING_DETAIL_NET_BUFFER_LIST_INFO-Struktur . SwitchForwardingDetail_b0_to_b31 und SwitchForwardingDetail_b32_to_b63 werden verwendet, um 64b-OOB-Daten für den 32b-Modus anzupassen. Verfügbar in NDIS 6.82 und höher.
`SwitchForwardingDetail_b32_to_b63` Siehe SwitchForwardingDetail_b0_to_b31.
`VirtualSubnetInfo` Gibt einen Zeiger auf eine vom Treiber zugewiesene NDIS_NET_BUFFER_LIST_VIRTUAL_SUBNET_INFO-Struktur an.
`NetBufferListInfoReserved1` Reserviert für NDIS.
`NetBufferListInfoReserved2` Reserviert für NDIS.
`MaxNetBufferListInfo` Der Höchstwert für diese Enumeration. Dieser Wert kann sich in zukünftigen Versionen der NDIS-Headerdateien und -Binärdateien ändern.

Hinweise

Die NDIS_NET_BUFFER_LIST_INFO-Enumeration wird in der NET_BUFFER_LIST-Struktur verwendet.

Verwenden Sie diese Enumerationswerte mit dem NET_BUFFER_LIST_INFO Makro, um Werte im NetBufferListInfo-Array in einem NET_BUFFER_LIST festzulegen und abzurufen.