struttura NDIS_FILTER_ATTACH_PARAMETERS (ndis.h)

Articolo
02/29/2024

La struttura NDIS_FILTER_ATTACH_PARAMETERS definisce i parametri di inizializzazione per il modulo di filtro.

Sintassi

typedef struct _NDIS_FILTER_ATTACH_PARAMETERS {
  NDIS_OBJECT_HEADER                Header;
  NET_IFINDEX                       IfIndex;
  NET_LUID                          NetLuid;
  PNDIS_STRING                      FilterModuleGuidName;
  NET_IFINDEX                       BaseMiniportIfIndex;
  PNDIS_STRING                      BaseMiniportInstanceName;
  PNDIS_STRING                      BaseMiniportName;
  NDIS_MEDIA_CONNECT_STATE          MediaConnectState;
  NET_IF_MEDIA_DUPLEX_STATE         MediaDuplexState;
  ULONG64                           XmitLinkSpeed;
  ULONG64                           RcvLinkSpeed;
  NDIS_MEDIUM                       MiniportMediaType;
  NDIS_PHYSICAL_MEDIUM              MiniportPhysicalMediaType;
  NDIS_HANDLE                       MiniportMediaSpecificAttributes;
  PNDIS_OFFLOAD                     DefaultOffloadConfiguration;
  USHORT                            MacAddressLength;
  UCHAR                             CurrentMacAddress[NDIS_MAX_PHYS_ADDRESS_LENGTH];
  NET_LUID                          BaseMiniportNetLuid;
  NET_IFINDEX                       LowerIfIndex;
  NET_LUID                          LowerIfNetLuid;
  ULONG                             Flags;
  PNDIS_HD_SPLIT_CURRENT_CONFIG     HDSplitCurrentConfig;
  PNDIS_RECEIVE_FILTER_CAPABILITIES ReceiveFilterCapabilities;
  PDEVICE_OBJECT                    MiniportPhysicalDeviceObject;
  PNDIS_NIC_SWITCH_CAPABILITIES     NicSwitchCapabilities;
  BOOLEAN                           BaseMiniportIfConnectorPresent;
  PNDIS_SRIOV_CAPABILITIES          SriovCapabilities;
  PNDIS_NIC_SWITCH_INFO_ARRAY       NicSwitchArray;
} NDIS_FILTER_ATTACH_PARAMETERS, *PNDIS_FILTER_ATTACH_PARAMETERS;

Members

Header

Struttura NDIS_OBJECT_HEADER per la struttura NDIS_FILTER_ATTACH_PARAMETERS . NDIS imposta il membro Type della struttura specificata da Header su NDIS_OBJECT_TYPE_FILTER_ATTACH_PARAMETERS.

Per indicare la versione della struttura NDIS_FILTER_ATTACH_PARAMETERS , NDIS imposta il membro Revision su uno dei valori seguenti:

NDIS_FILTER_ATTACH__PARAMETERS_REVISION_4

Sono stati aggiunti vari membri per NDIS 6.30.

NDIS imposta il membro Size su NDIS_SIZEOF_FILTER_ATTACH_PARAMETERS_REVISION_4.

NDIS_FILTER_ATTACH_PARAMETERS_REVISION_3

Sono stati aggiunti i membri ReceiveFilterCapabilities, MiniportPhysicalDeviceObject e NicSwitchCapabilities per NDIS 6.20.

NDIS imposta il membro Size su NDIS_SIZEOF_FILTER_ATTACH_PARAMETERS_REVISION_3.

NDIS_FILTER_ATTACH_PARAMETERS_REVISION_2

Aggiunto il membro HDSplitCurrentConfig per NDIS 6.1.

NDIS imposta il membro Size su NDIS_SIZEOF_FILTER_ATTACH_PARAMETERS_REVISION_2.

NDIS_FILTER_ATTACH_PARAMETERS_REVISION_1

Versione originale per NDIS 6.0.

NDIS imposta il membro Size su NDIS_SIZEOF_FILTER_ATTACH_PARAMETERS_REVISION_1.

IfIndex

Indice dell'interfaccia NDIS del modulo di filtro associato allo stack di driver.

NetLuid

L'interfaccia di rete NDIS NET_LUID valore per il modulo di filtro che NDIS sta collegando allo stack di driver. Il NET_LUID equivale al nome dell'interfaccia (ifName in RFC 2863 ).

FilterModuleGuidName

Nome GUID del modulo di filtro associato da NDIS.

BaseMiniportIfIndex

Indice dell'interfaccia di rete NDIS della scheda miniport di base. Ovvero, se sono presenti miniport virtuali o moduli di filtro installati su un adattatore miniport fisico, il valore di questo membro è l'indice di interfaccia dell'adattatore miniport fisico o un miniport virtuale del driver intermedio MUX di livello più alto.

BaseMiniportInstanceName

Puntatore a un valore di tipo NDIS_STRING che contiene una stringa Unicode con conteggiata. Questa stringa specifica il nome descrittivo dell'interfaccia per l'adattatore miniport di base. Per Windows 2000 e versioni successive, NDIS definisce il tipo di NDIS_STRING come tipo di UNICODE_STRING .

BaseMiniportName

Nome dell'adattatore miniport di base.

MediaConnectState

The NET_IF_MEDIA_CONNECT_STATE tipo di stato della connessione.

MediaDuplexState

Stato duplex multimediale per l'adattatore miniport sottostante. Per altre informazioni, vedere OID_GEN_MEDIA_DUPLEX_STATE.

XmitLinkSpeed

Velocità di collegamento di trasmissione corrente dell'adattatore miniport sottostante in bit al secondo. Per altre informazioni, vedere OID_GEN_LINK_SPEED_EX.

RcvLinkSpeed

Velocità di collegamento di ricezione corrente dell'adattatore miniport sottostante in bit al secondo. Per altre informazioni, vedere OID_GEN_LINK_SPEED_EX.

MiniportMediaType

Tipo NdisMediumXxx supportato dall'adattatore miniport sottostante di base. Per altre informazioni, vedere NDIS_MEDIUM.

MiniportPhysicalMediaType

Tipo di supporto fisico per l'adattatore miniport sottostante di base. Per altre informazioni, vedere OID_GEN_PHYSICAL_MEDIUM.

MiniportMediaSpecificAttributes

Puntatore a una struttura NDIS_OBJECT_HEADER che identifica una struttura che contiene attributi specifici del supporto miniport o NULL se tali attributi non sono presenti. Il membro Type della struttura NDIS_OBJECT_HEADER identifica il tipo della struttura degli attributi. Ad esempio, se il tipo di supporto dell'adattatore miniport sottostante è NdisMediumNative802_11, il membro Type deve essere NDIS_OBJECT_TYPE_MINIPORT_ADAPTER_NATIVE_802_11_ATTRIBUTES e il membro MiniportMediaSpecificAttributes punta a un oggetto NDIS_MINIPORT_ADAPTER_NATIVE_802_11_ATTRIBUTES struttura.

DefaultOffloadConfiguration

Puntatore a una struttura di NDIS_OFFLOAD che definisce gli attributi di offload dell'attività. Il driver di filtro deve esaminare questi attributi per ottenere le funzionalità di offload delle attività dei driver sottostanti. Il driver di filtro deve modificare questi attributi, se necessario, per riflettere le modifiche apportate al supporto dell'offload dell'attività richiesto.

MacAddressLength

Lunghezza dell'indirizzo MAC, in byte. La lunghezza dell'indirizzo MAC è specifica per il tipo di supporto.

CurrentMacAddress[NDIS_MAX_PHYS_ADDRESS_LENGTH]

Indirizzo MAC corrente. Ad esempio, l'OID OID_802_3_CURRENT_ADDRESS specifica l'indirizzo MAC corrente per i driver IEEE 802.3.

BaseMiniportNetLuid

L'interfaccia di rete NDIS NET_LUID della scheda miniport di base. Ovvero, se sono presenti miniport virtuali o moduli di filtro installati su un adattatore miniport fisico, il valore di questo membro è il NET_LUID della scheda miniport fisica o un miniport virtuale del driver intermedio MUX di livello più alto.

LowerIfIndex

Indice dell'interfaccia di rete NDIS dell'interfaccia subito sotto il modulo di filtro corrente. Ovvero, se sono presenti moduli di filtro o NDIS 5. Driver intermedi di filtro x installati su un adattatore miniport fisico o il driver intermedio MUX di livello più alto, questo membro contiene l'indice di interfaccia dell'interfaccia del modulo di filtro o l'interfaccia del driver intermedio di filtro che si trova appena sotto il modulo di filtro corrente. Se non sono presenti interfacce di filtro o driver intermedie di filtro installate tramite l'adattatore miniport fisico o il driver intermedio MUX di livello più alto, questo membro contiene l'indice dell'interfaccia della scheda miniport fisica sottostante o il miniport virtuale del driver intermedio MUX di livello più alto.

LowerIfNetLuid

L'interfaccia di rete NDIS NET_LUID valore dell'interfaccia subito sotto il modulo di filtro corrente. Ovvero, se sono presenti moduli di filtro o NDIS 5. Driver intermedi di filtro x installati su una scheda miniport fisica o il driver intermedio MUX di livello più alto, questo membro contiene l'interfaccia di rete NET_LUID dell'interfaccia del modulo di filtro o dell'interfaccia del driver intermedio filtro che si trova appena sotto il modulo di filtro corrente. Se non sono presenti interfacce di filtro o driver intermedie di filtro installate sulla scheda miniport fisica o sul driver intermedio MUX di livello più alto, questo membro contiene l'interfaccia di rete NET_LUID della scheda miniport fisica sottostante o il miniport virtuale del driver intermedio MUX di livello più alto.

Flags

Riservato per utilizzi futuri.

HDSplitCurrentConfig

Puntatore a un oggetto NDIS_HD_SPLIT_CURRENT_CONFIG struttura. Questa struttura specifica la configurazione corrente della suddivisione dei dati di intestazione dell'adattatore miniport sottostante. Questo valore può essere NULL se l'adattatore miniport non supporta la divisione dei dati di intestazione.

ReceiveFilterCapabilities

Puntatore a un oggetto NDIS_RECEIVE_FILTER_CAPABILITIES struttura. Questa struttura specifica le funzionalità di filtro generiche attualmente abilitate nell'adattatore miniport sottostante. Questo valore può essere NULL se l'adattatore miniport non supporta il filtro di ricezione.

MiniportPhysicalDeviceObject

Puntatore a una struttura DEVICE_OBJECT . Questa struttura rappresenta il dispositivo fisico per l'adattatore miniport sottostante.

NicSwitchCapabilities

Puntatore a un oggetto NDIS_NIC_SWITCH_CAPABILITIES struttura. Questa struttura specifica le funzionalità del commutatore della scheda di interfaccia di rete dell'adattatore miniport sottostante. Questo valore può essere NULL se l'adattatore miniport non supporta le funzionalità del commutatore della scheda di interfaccia di rete.

BaseMiniportIfConnectorPresent

Valore booleano che, se impostato su TRUE, indica se nella scheda di rete sottostante è presente un connettore di interfaccia di rete (se). Questo valore deve essere impostato su TRUE per un adattatore fisico.

SriovCapabilities

Puntatore a una struttura NDIS_SRIOV_CAPABILITIES . Questa struttura specifica le singole funzionalità di virtualizzazione I/O radice (SR-IOV) attualmente abilitate nell'adattatore miniport sottostante. Questo valore può essere NULL se l'adattatore miniport non supporta le funzionalità SR-IOV.

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

NicSwitchArray

Puntatore a una struttura NDIS_NIC_SWITCH_INFO_ARRAY . Questa matrice enumera le opzioni della scheda di interfaccia di rete create nell'adattatore miniport. Le opzioni della scheda di interfaccia di rete possono essere create solo se SR-IOV è supportato e abilitato nella scheda.

Nota A partire da Windows Server 2012, Windows supporta solo l'opzione di interfaccia di rete predefinita creata nella scheda miniport della funzione fisica (PF). Pertanto, questa matrice può contenere un solo elemento.

Commenti

Per definire i parametri di collegamento del modulo di filtro, NDIS passa un puntatore a una struttura NDIS_FILTER_ATTACH_PARAMETERS alla funzione FilterAttach .

I driver di filtro devono evitare di eseguire query OID non necessarie. Usare invece le informazioni in NDIS_FILTER_ATTACH_PARAMETERS, se disponibili, per ottenere informazioni sui driver sottostanti.