enumerazione NDIS_NET_BUFFER_LIST_INFO (ndis/nblinfo.h)

Articolo
02/07/2025

L'enumerazione NDIS_NET_BUFFER_LIST_INFO identifica le informazioni comuni a tutte le strutture NET_BUFFER in una struttura NET_BUFFER_LIST.

Sintassi

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;

Costanti


`TcpIpChecksumNetBufferListInfo` Identifica le informazioni di checksum usate per l'offload delle attività di checksum dal protocollo TCP/IP a un conducente miniport. Quando viene specificato il TcpIpChecksumNetBufferListInfo, la macro NET_BUFFER_LIST_INFO restituisce un valore NDIS_TCP_IP_CHECKSUM_NET_BUFFER_LIST_INFO struttura. Questa struttura contiene un'unione che consente informazioni sul checksum a cui accedere come singolo valore PVOID o come campi di bit.
`TcpOffloadBytesTransferred` Identifica un valore di ULONG che corrisponde al numero di byte di dati trasferiti in un camino TCP offload dell'operazione di invio, ricezione o disconnessione.
`IPsecOffloadV1NetBufferListInfo` Identifica le informazioni di sicurezza del protocollo Internet (IPsec) usate per l'offload delle attività IPsec dal protocollo TCP/IP a un driver miniport. Quando viene specificato IPsecOffloadV1NetBufferListInfo, NET_BUFFER_LIST_INFO restituisce un valore NDIS_IPSEC_OFFLOAD_V1_NET_BUFFER_LIST_INFO struttura.
`IPsecOffloadV2NetBufferListInfo` Specifica le informazioni di offload di sicurezza del protocollo Internet versione 2 (IPsecV2) usate in offload delle attività IPsec dal protocollo TCP/IP a un driver miniport. Quando si specifica IPsecOffloadV2NetBufferListInfo, NET_BUFFER_LIST_INFO restituisce un valore NDIS_IPSEC_OFFLOAD_V2_NET_BUFFER_LIST_INFO struttura.
`TcpLargeSendNetBufferListInfo` Identifica le informazioni utilizzate per l'offload della segmentazione di un pacchetto TCP di grandi dimensioni da Protocollo TCP/IP a un adattatore miniport per offload di invio di grandi dimensioni versione 1 (LSOV1) e offload di invio di grandi dimensioni versione 2 (LSOV2). Quando viene specificato il TcpLargeSendNetBufferListInfo, NET_BUFFER_LIST_INFO restituisce un valore NDIS_TCP_LARGE_SEND_OFFLOAD_NET_BUFFER_LIST_INFO struttura. Questa struttura contiene un'unione che consente di accedere alle informazioni come un singolo valore PVOID o come campi di bit. Prima di passare un pacchetto TCP di grandi dimensioni a un driver miniport per la segmentazione, il protocollo TCP/IP scrive i valori nell'oggetto LsoV1Transmit membro del struttura NDIS_TCP_LARGE_SEND_OFFLOAD_NET_BUFFER_LIST_INFO per LSOV1 o il membro LsoV2Transmit per LSOV2. Prima di completare l'invio di un pacchetto TCP di grandi dimensioni segmentato in pacchetti più piccoli, un driver miniport scrive i valori in LsoV1TransmitComplete membro del struttura NDIS_TCP_LARGE_SEND_OFFLOAD_NET_BUFFER_LIST_INFO per LSOV1 o membro LsoV2TransmitComplete per LSOV2. Per LSOV1, il valore scritto dal driver miniport include il numero totale di byte di payload TCP inviati dal driver miniport nei pacchetti inviati segmentato dal pacchetto TCP di grandi dimensioni.
`TcpReceiveNoPush` Identifica un valore booleano che rappresenta la modalità push di una richiesta di ricezione offload del camino TCP. Se TRUE, la richiesta di ricezione è in modalità non push. In caso contrario, la richiesta di ricezione è in modalità push.
`ClassificationHandleNetBufferListInfo` Riservato.
`Ieee8021QNetBufferListInfo` Identifica le informazioni 802.1Q su un pacchetto. Quando viene specificato il Ieee8021QNetBufferListInfo, NET_BUFFER_LIST_INFO restituisce membro value di un NDIS_NET_BUFFER_LIST_8021Q_INFO struttura. Questa struttura può specificare la priorità 802.1p e la VLAN informazioni sull'identificatore. Le informazioni sulla priorità 802.1p vengono usate per stabilire la priorità dei pacchetti nei supporti condivisi 802 reti. I driver Miniport che supportano il tag 802.1Q nell'hardware devono usare NDIS_NET_BUFFER_LIST_8021Q_INFO struttura per le operazioni di trasmissione e ricezione.
`NetBufferListCancelId` Identifica un valore ULONG_PTR che rappresenta un identificatore di annullamento per l'oggetto NET_BUFFER_LIST struttura. Per annullare l'oggetto trasmissione in sospeso di una struttura di NET_BUFFER_LIST contrassegnata, un driver di protocollo passa il pacchetto identificatore di annullamento in NdisCancelSendNetBufferLists. I driver devono chiamare NdisGeneratePartialCancelId per ottenere un valore che il driver deve usare come byte di ordine elevato di un oggetto identificatore di annullamento.
`MediaSpecificInformation` Identifica un valore PVOID che rappresenta l'indirizzo di un buffer allocato dal driver. Questo buffer contiene tutti i dati out-of-band specifici del supporto che accompagnano il NET_BUFFER strutture associate a struttura NET_BUFFER_LIST. Se un driver di protocollo ha allocato i dati fuori banda, ha configurato dati per un'operazione di invio. Se un driver miniport ha allocato i dati, ha configurato i dati per una ricezione indicazione.
`NetBufferListFrameType` Identifica un valore USHORT che rappresenta il tipo di frame dei pacchetti Ethernet ricevuti.
`NetBufferListProtocolId` Identifica un valore UCHAR che è un identificatore di protocollo come uno dei valori seguenti: NDIS_PROTOCOL_ID_DEFAULT Identificatore del driver di protocollo predefinito. NDIS_PROTOCOL_ID_TCP_IP Protocollo TCP/IP. NDIS_PROTOCOL_ID_IPX Protocollo IPX. NDIS_PROTOCOL_ID_NBF Protocollo NetBEUI.
`NetBufferListHashValue` Nel percorso di ricezione, NetBufferListHashValue identifica un valore ULONG che rappresenta il valore hash RSS calcolato da una scheda di interfaccia di rete. se presenti. Sul percorso di trasmissione, NetBufferListHashValue identifica un valore ULONG che corrisponde al valore hash RSS calcolato da TCP/IP. se presenti. In questo caso, tutte le strutture NET_BUFFER in una struttura NET_BUFFER_LIST inviata da TCP/IP appartengono alla stessa connessione UDP o TCP. Di conseguenza, questo valore hash si applica a tutti i NET_BUFFER strutture presenti nella struttura NET_BUFFER_LIST. Per altre informazioni, vedere che indica la ricezione RSS Data.
`NetBufferListHashInfo` Identifica un valore ULONG che rappresenta le informazioni sull'hash RSS, che include la funzione hash e tipo hash. Per altre informazioni, vedere che indica la ricezione RSS Data.
`WfpNetBufferListInfo` Riservato per l'uso da parte di Windows Filtering Platform (WFP). Nessun conducente, incluso il callout DEL WFP driver, possono archiviare informazioni usando questo valore.
`IPsecOffloadV2TunnelNetBufferListInfo` Specifica le informazioni sul tunnel IPsecV2 usate per l'offload delle attività IPsec dal protocollo TCP/IP a un conducente miniport. Quando si specifica IPsecOffloadV2TunnelNetBufferListInfo, NET_BUFFER_LIST_INFO restituisce un valore NDIS_IPSEC_OFFLOAD_V2_TUNNEL_NET_BUFFER_LIST_INFO struttura.
`IPsecOffloadV2HeaderNetBufferListInfo` Specifica le informazioni sull'intestazione IPsecV2 usate per l'offload delle attività IPsec dal protocollo TCP/IP a un conducente miniport. Quando si specifica IPsecOffloadV2HeaderNetBufferListInfo, NET_BUFFER_LIST_INFO restituisce un valore NDIS_IPSEC_OFFLOAD_V2_HEADER_NET_BUFFER_LIST_INFO struttura.
`NetBufferListCorrelationId` Riservato.
`NetBufferListFilteringInfo` Specifica le informazioni di filtro usate nell'interfaccia VMQ (Virtual Machine Queue), l'interfaccia di virtualizzazione I/O radice singola (SR-IOV) e l'unione dei pacchetti NDIS. Quando si specifica NetBufferListFilteringInfo, NET_BUFFER_LIST_INFO restituisce un valore NDIS_NET_BUFFER_LIST_FILTERING_INFO struttura. A partire da NDIS 6.20, ricevere indicazioni effettuate da driver miniport che supportano VMQ, SR-IOV o unione di pacchetti devono includere una struttura NDIS_NET_BUFFER_LIST_FILTERING_INFO. I driver miniport devono impostare l'identificatore della coda VMQ nel membro QueueId del NDIS_NET_BUFFER_LIST_FILTERING_INFO struttura. Il driver imposta anche il FilterId membro della struttura NDIS_NET_BUFFER_LIST_FILTERING_INFO su zero. Nota A partire da NDIS 6.30, il driver miniport che supporta l'unione di pacchetti o SR-IOV deve impostare il QueueId su NDIS_DEFAULT_RECEIVE_QUEUE_ID e sul membro FilterId su zero.
`MediaSpecificInformationEx` Identifica un puntatore a un driver allocato NDIS_NBL_MEDIA_SPECIFIC_INFORMATION_EX struttura. Questa struttura identifica qualsiasi elemento specifico del supporto dati fuori banda che accompagnano le strutture NET_BUFFER associate al NET_BUFFER_LIST struttura. I driver NDIS 6.20 e versioni successive devono usare il struttura NDIS_NBL_MEDIA_SPECIFIC_INFORMATION_EX per specificare informazioni specifiche sui supporti. Qualsiasi driver in uno stack di driver NDIS può allocare e gestire informazioni specifiche dei supporti.
`NblOriginalInterfaceIfIndex` Riservato.
`NblReAuthWfpFlowContext` Riservato.
`TcpReceiveBytesTransferred` Identifica un valore ULONG che corrisponde al numero di byte di dati ricevuti dallo stack host e compilare la richiesta di ricezione che viene elaborata come operazione di ricezione offload del camino TCP.
`NrtNameResolutionId` Riservato.
`UdpRecvSegCoalesceOffloadInfo` Identifica le informazioni URO (Udp Receive Segment Coalescing Offload). Quando si specifica udpRecvSegCoalesceOffloadInfo, NET_BUFFER_LIST_INFO restituisce una struttura NDIS_UDP_RSC_OFFLOAD_NET_BUFFER_LIST_INFO. Questa struttura contiene un'unione che consente ai driver di accedere alle informazioni come singolo valore PVOID.
`SwitchForwardingReserved` Riservato per NDIS.
`SwitchForwardingDetail` Identifica un puntatore a una struttura NDIS_SWITCH_FORWARDING_DETAIL_NET_BUFFER_LIST_INFO allocata dal driver. Questa struttura specifica le informazioni per l'inoltro di un pacchetto a una o più porte di un commutatore estendibile Hyper-V. Il driver alloca questa struttura chiamando AllocateNetBufferListForwardingContext e libera la struttura chiamando FreeNetBufferListForwardingContext.
`VirtualSubnetInfo` Identifica un puntatore a una struttura di NDIS_NET_BUFFER_LIST_VIRTUAL_SUBNET_INFO allocata dal driver.
`IMReserved` Riservato per NDIS.
`TcpRecvSegCoalesceInfo` Identifica le informazioni di unione dei segmenti di ricezione (RSC). Quando si specifica TcpRecvSegCoalesceInfo, NET_BUFFER_LIST_INFO restituisce un'unione NDIS_RSC_NBL_INFO. Questa unione consente ai driver di accedere alle informazioni come singolo valore PVOID.
`UdpSegmentationOffloadInfo` Identifica le informazioni utilizzate per l'offload della segmentazione di un pacchetto UDP di grandi dimensioni dal protocollo TCP/IP a una scheda miniport per l'offload segmentazione UDP (USO). Quando si specifica UdpSegmentationOffloadInfo, NET_BUFFER_LIST_INFO restituisce una struttura NDIS_UDP_SEGMENTATION_OFFLOAD_NET_BUFFER_LIST_INFO. Questa struttura contiene un'unione che consente ai driver di accedere alle informazioni come un singolo valore PVOID o come campi di bit.
`RscTcpTimestampDelta` Identifica un valore di ULONG contenente informazioni sul timestamp RSC. Per altre informazioni, vedere la documentazione NDIS_RSC_NBL_INFO.
`TcpSendOffloadsSupplementalNetBufferListInfo` Identifica un puntatore a una struttura NDIS_TCP_SEND_OFFLOADS_SUPPLEMENTAL_NET_BUFFER_LIST_INFO allocata dal driver contenente informazioni aggiuntive fuori banda per i pacchetti incapsulati.
`GftOffloadInformation` Informazioni sull'offload GFT (Generic Flow Table).
`GftFlowEntryId` ID voce del flusso per GFT.
`NetBufferListInfoReserved3` Riservato.
`SwitchForwardingReserved` Riservato per NDIS.
`SwitchForwardingDetail_b0_to_b31` Identifica un puntatore a una struttura NDIS_SWITCH_FORWARDING_DETAIL_NET_BUFFER_LIST_INFO allocata dal driver. SwitchForwardingDetail_b0_to_b31 e SwitchForwardingDetail_b32_to_b63 vengono usati per adattare i dati OOB a 64b per la modalità 32b. Disponibile in NDIS 6.82 e versioni successive.
`SwitchForwardingDetail_b32_to_b63` Vedere SwitchForwardingDetail_b0_to_b31.
`VirtualSubnetInfo` Identifica un puntatore a una struttura di NDIS_NET_BUFFER_LIST_VIRTUAL_SUBNET_INFO allocata dal driver.
`NetBufferListInfoReserved1` Riservato per NDIS.
`NetBufferListInfoReserved2` Riservato per NDIS.
`MaxNetBufferListInfo` Valore massimo per questa enumerazione. Questo valore potrebbe cambiare nelle versioni future dei file di intestazione e dei file binari NDIS.

Osservazioni

L'enumerazione NDIS_NET_BUFFER_LIST_INFO viene utilizzata nella struttura NET_BUFFER_LIST.

Usare questi valori di enumerazione con la macro NET_BUFFER_LIST_INFO per impostare e ottenere valori nella matrice netBufferListInfo in un NET_BUFFER_LIST.