struttura NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES (ndis.h)

Articolo
08/07/2023

La struttura NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES specifica gli attributi hardware della scheda di rete.

Sintassi

typedef struct _NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES {
  NDIS_OBJECT_HEADER                Header;
  PNDIS_HD_SPLIT_ATTRIBUTES         HDSplitAttributes;
  PNDIS_RECEIVE_FILTER_CAPABILITIES HardwareReceiveFilterCapabilities;
  PNDIS_RECEIVE_FILTER_CAPABILITIES CurrentReceiveFilterCapabilities;
  PNDIS_NIC_SWITCH_CAPABILITIES     HardwareNicSwitchCapabilities;
  PNDIS_NIC_SWITCH_CAPABILITIES     CurrentNicSwitchCapabilities;
  PNDIS_SRIOV_CAPABILITIES          HardwareSriovCapabilities;
  PNDIS_SRIOV_CAPABILITIES          CurrentSriovCapabilities;
  PNDIS_QOS_CAPABILITIES            HardwareQosCapabilities;
  PNDIS_QOS_CAPABILITIES            CurrentQosCapabilities;
  PNDIS_GFT_OFFLOAD_CAPABILITIES    HardwareGftOffloadCapabilities;
  PNDIS_GFT_OFFLOAD_CAPABILITIES    CurrentGftOffloadCapabilities;
} NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES, *PNDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES;

Membri

Header

Struttura NDIS_OBJECT_HEADER per la struttura NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES. Il driver imposta il membro Type della struttura che Header specifica di NDIS_OBJECT_TYPE_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES.

Per indicare la versione della struttura NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES, impostare il membro revisione su uno dei valori seguenti:

NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES_REVISION_3

Aggiunta di vari membri per NDIS 6.30.

Impostare il membro dimensioni su NDIS_SIZEOF_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES_REVISION_3.

NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES_REVISION_2

Aggiunta del HardwareReceiveFilterCapabilities, CurrentReceiveFilterCapabilities, HardwareNicSwitchCapabilitiese CurrentNicSwitchCapabilities membri per NDIS 6.20.

Impostare il membro Dimensioni su NDIS_SIZEOF_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES_REVISION_2.

NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES_REVISION_1

Versione originale per NDIS 6.1.

Impostare il membro dimensioni su NDIS_SIZEOF_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES_REVISION_1.

HDSplitAttributes

Puntatore a una struttura NDIS_HD_SPLIT_ATTRIBUTES che rappresenta le funzionalità di suddivisione dei dati di intestazione fornite dalla scheda di rete. Se la scheda di rete non supporta la funzionalità di suddivisione dei dati di intestazione, impostare HDSplitAttributes su NULL.

HardwareReceiveFilterCapabilities

Puntatore a un oggetto NDIS_RECEIVE_FILTER_CAPABILITIES struttura. Questa struttura specifica le funzionalità di filtro di ricezione hardware della scheda di rete. Questo valore può essere null se la scheda di rete non supporta il filtro di ricezione.

Avviso Se questo membro non è impostato su NULL, il membro CurrentReceiveFilterCapabilities non deve essere impostato su NULL.

CurrentReceiveFilterCapabilities

Puntatore a una struttura NDIS_RECEIVE_FILTER_CAPABILITIES. Questa struttura specifica le funzionalità di filtro di ricezione attualmente abilitate nella scheda di rete. Questo valore può essere null se la scheda di rete non supporta il filtro di ricezione.

Avviso Se questo membro non è impostato su NULL, il membro HardwareReceiveFilterCapabilities non deve essere impostato su NULL.

HardwareNicSwitchCapabilities

Puntatore a un oggetto NDIS_NIC_SWITCH_CAPABILITIES struttura. Questa struttura specifica le funzionalità del commutatore scheda di interfaccia di rete hardware della scheda di rete. Questo valore può essere NULL se la scheda di rete non supporta le funzionalità del commutatore NIC o riceve filtri.

Avviso Se questo membro non è impostato su NULL, il membro CurrentNicSwitchCapabilities non deve essere impostato su NULL.

CurrentNicSwitchCapabilities

Puntatore a una struttura NDIS_NIC_SWITCH_CAPABILITIES. Questa struttura specifica le funzionalità del commutatore NIC attualmente abilitate nella scheda di rete. Questo valore può essere NULL se la scheda di rete non supporta le funzionalità del commutatore NIC o riceve filtri.

Avviso Se questo membro non è impostato su NULL, il membro HardwareNicSwitchCapabilities non deve essere impostato su NULL.

HardwareSriovCapabilities

Puntatore a una struttura NDIS_SRIOV_CAPABILITIES. Questa struttura specifica le funzionalità di virtualizzazione di I/O radice singola (SR-IOV) dell'hardware della scheda di rete. Questo valore può essere NULL se la scheda di rete non supporta SR-IOV.

Per altre informazioni su SR-IOV, vedere Single Root I/O Virtualization (SR-IOV).

Nota Se questo membro non è impostato su NULL, i membri CurrentSriovCapabilities, HardwareNicSwitchCapabilitiese i membri CurrentNicSwitchCapabilities non devono essere impostati su NULL.

CurrentSriovCapabilities

Puntatore a una struttura NDIS_SRIOV_CAPABILITIES. Questa struttura specifica le funzionalità di SR-IOV attualmente abilitate nella scheda di rete. Questo valore può essere NULL se la scheda di rete non supporta SR-IOV.

Nota Se questo membro non è impostato su NULL, i membri HardwareSriovCapabilities, HardwareNicSwitchCapabilitiese Membri CurrentNicSwitchCapabilities non devono essere impostati su NULL.

HardwareQosCapabilities

Puntatore a una struttura NDIS_QOS_CAPABILITIES. Questa struttura specifica le funzionalità hardware supportate dalla scheda di rete per la qualità del servizio (QoS) NDIS sull'interfaccia IEEE 802.1 Data Center Bridging (DCB). Questo valore può essere null se la scheda di rete non supporta le funzionalità hardware QoS NDIS per DCB.

Per altre informazioni, vedere NDIS QoS for Data Center Bridging.

Nota Se questo membro non è impostato su NULL, il membro CurrentQosCapabilities non deve essere impostato su NULL.

CurrentQosCapabilities

Puntatore a una struttura NDIS_QOS_CAPABILITIES. Questa struttura specifica le funzionalità hardware attualmente abilitate nella scheda di rete per QoS NDIS tramite l'interfaccia DCB. Questo valore può essere null se la scheda di rete non supporta le funzionalità hardware QoS NDIS per DCB.

Se l'adattatore supporta le funzionalità QoS NDIS, ma tali funzionalità sono disabilitate, il driver miniport deve impostare tutti i membri della struttura NDIS_QOS_CAPABILITIES (ad eccezione del membro header) su zero.

Nota Se questo membro non è impostato su NULL, il membro HardwareQosCapabilities non deve essere impostato su NULL.

HardwareGftOffloadCapabilities

CurrentGftOffloadCapabilities

Osservazioni

Per registrare le funzionalità supportate dall'hardware della scheda di rete sottostante, il driver miniport chiama funzione NdisMSetMiniportAttributes dalla funzione MiniportInitializeEx. Il driver passa una struttura di NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES inizializzata al parametro MiniportAttributes di questa funzione.