enumerazione NDIS_NET_BUFFER_LIST_INFO (ndis/nblinfo.h)

Articolo
03/05/2024

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 utilizzate per l'offload delle attività di checksum dal protocollo TCP/IP a un conducente miniport. Se Viene specificato 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 le informazioni di checksum a cui accedere come singolo valore PVOID o come campi di bit.
`TcpOffloadBytesTransferred` Identifica un valore ULONG che rappresenta il 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. Se 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 dal Protocollo TCP/IP in un adattatore miniport per offload di trasmissione di grandi dimensioni versione 1 (LSOV1) e offload di invio di grandi dimensioni versione 2 (LSOV2). Se Viene specificato 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 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, valore scritto dal driver miniport include il numero totale di byte di payload TCP inviati dal driver miniport nei pacchetti segmentato dal pacchetto TCP di grandi dimensioni.
`TcpReceiveNoPush` Identifica un valore booleano che rappresenta la modalità push di una richiesta di ricezione di 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. Se Ieee8021QNetBufferListInfo è specificato, NET_BUFFER_LIST_INFO restituisce Membro valore di un oggetto 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 il 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 a 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 qualsiasi dato fuori banda specifico del supporto che accompagna l'oggetto 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 corrisponde al 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. Pertanto, questo valore hash si applica a tutte le NET_BUFFER strutture presenti nella struttura NET_BUFFER_LIST . Per ulteriori informazioni, vedere Indicazione della ricezione RSS Dati.
`NetBufferListHashInfo` Identifica un valore ULONG che rappresenta le informazioni sull'hash RSS, che include la funzione hash e tipo hash. Per ulteriori informazioni, vedere Indicazione della ricezione RSS Dati.
`WfpNetBufferListInfo` Riservato per l'uso da parte di Windows Filtering Platform (WFP). Nessun conducente, incluso il callout del WFP i driver possono archiviare le 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 la unione dei pacchetti NDIS. Quando si specifica NetBufferListFilteringInfo, NET_BUFFER_LIST_INFO restituisce NDIS_NET_BUFFER_LIST_FILTERING_INFO struttura. A partire da NDIS 6.20, ricevere indicazioni effettuate dai driver miniport che supportano VMQ, SR-IOV o coalescing 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 dell'oggetto NDIS_NET_BUFFER_LIST_FILTERING_INFO struttura. Il driver imposta anche il membro FilterId della struttura NDIS_NET_BUFFER_LIST_FILTERING_INFO su zero. Nota A partire da NDIS 6.30, il driver miniport che supporta SR-IOV o l'unione di pacchetti deve impostare QueueId su NDIS_DEFAULT_RECEIVE_QUEUE_ID e il membro FilterId su zero.
`MediaSpecificInformationEx` Identifica un puntatore a un driver allocato NDIS_NBL_MEDIA_SPECIFIC_INFORMATION_EX struttura. Questa struttura identifica tutti i supporti specifici 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 del supporto.
`NblOriginalInterfaceIfIndex` Riservato.
`NblReAuthWfpFlowContext` Riservato.
`TcpReceiveBytesTransferred` Identifica un valore ULONG che rappresenta il 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 (Coalescing Offload) del segmento di ricezione UDP. Quando viene specificato 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 del segmento di ricezione (RSC). Quando viene specificato 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 offload segmentazione UDP (USO). Quando viene specificato 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 singolo valore PVOID o come campi di bit.
`RscTcpTimestampDelta` Identifica un valore ULONG contenente informazioni sul timestamp RSC. Per altre informazioni, vedere la documentazione di NDIS_RSC_NBL_INFO .
`TcpSendOffloadsSupplementalNetBufferListInfo` Identifica un puntatore a una struttura di 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 di 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 dell'enumerazione. Questo valore potrebbe cambiare nelle versioni future dei file di intestazione NDIS e dei file binari.

Commenti

L'enumerazione NDIS_NET_BUFFER_LIST_INFO viene utilizzata nella struttura NET_BUFFER_LIST .

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