struttura NDIS_BIND_PARAMETERS (ndis.h)
NDIS inizializza una struttura NDIS_BIND_PARAMETERS con informazioni che definiscono le caratteristiche di un'associazione e la passano a un driver di protocollo.
Sintassi
typedef struct _NDIS_BIND_PARAMETERS {
NDIS_OBJECT_HEADER Header;
PNDIS_STRING ProtocolSection;
PNDIS_STRING AdapterName;
PDEVICE_OBJECT PhysicalDeviceObject;
NDIS_MEDIUM MediaType;
ULONG MtuSize;
ULONG64 MaxXmitLinkSpeed;
ULONG64 XmitLinkSpeed;
ULONG64 MaxRcvLinkSpeed;
ULONG64 RcvLinkSpeed;
NDIS_MEDIA_CONNECT_STATE MediaConnectState;
NDIS_MEDIA_DUPLEX_STATE MediaDuplexState;
ULONG LookaheadSize;
PNDIS_PNP_CAPABILITIES PowerManagementCapabilities;
ULONG SupportedPacketFilters;
ULONG MaxMulticastListSize;
USHORT MacAddressLength;
UCHAR CurrentMacAddress[NDIS_MAX_PHYS_ADDRESS_LENGTH];
NDIS_PHYSICAL_MEDIUM PhysicalMediumType;
PNDIS_RECEIVE_SCALE_CAPABILITIES RcvScaleCapabilities;
NET_LUID BoundIfNetluid;
NET_IFINDEX BoundIfIndex;
NET_LUID LowestIfNetluid;
NET_IFINDEX LowestIfIndex;
NET_IF_ACCESS_TYPE AccessType;
NET_IF_DIRECTION_TYPE DirectionType;
NET_IF_CONNECTION_TYPE ConnectionType;
NET_IFTYPE IfType;
BOOLEAN IfConnectorPresent;
PNDIS_PORT ActivePorts;
ULONG DataBackFillSize;
ULONG ContextBackFillSize;
ULONG MacOptions;
NET_IF_COMPARTMENT_ID CompartmentId;
PNDIS_OFFLOAD DefaultOffloadConfiguration;
PNDIS_TCP_CONNECTION_OFFLOAD TcpConnectionOffloadCapabilities;
PNDIS_STRING BoundAdapterName;
PNDIS_HD_SPLIT_CURRENT_CONFIG HDSplitCurrentConfig;
PNDIS_RECEIVE_FILTER_CAPABILITIES ReceiveFilterCapabilities;
PNDIS_PM_CAPABILITIES PowerManagementCapabilitiesEx;
PNDIS_NIC_SWITCH_CAPABILITIES NicSwitchCapabilities;
BOOLEAN NDKEnabled;
PNDIS_NDK_CAPABILITIES NDKCapabilities;
PNDIS_SRIOV_CAPABILITIES SriovCapabilities;
PNDIS_NIC_SWITCH_INFO_ARRAY NicSwitchArray;
} NDIS_BIND_PARAMETERS, *PNDIS_BIND_PARAMETERS;
Members
Header
Struttura NDIS_OBJECT_HEADER per la struttura NDIS_BIND_PARAMETERS . NDIS imposta il membro Type della struttura specificata da Header su NDIS_OBJECT_TYPE_BIND_PARAMETERS.
Per indicare la versione della struttura NDIS_BIND_PARAMETERS, NDIS imposta il membro Revision su uno dei valori seguenti:
NDIS_BIND_PARAMETERS_REVISION_4
Sono stati aggiunti vari membri per NDIS 6.30.
NDIS imposta il membro Size su NDIS_SIZEOF_BIND_PARAMETERS_REVISION_4.
NDIS_BIND_PARAMETERS_REVISION_3
Sono stati aggiunti i membri ReceiveFilterCapabilities, PowerManagementCapabilitiesEx e NicSwitchCapabilities per NDIS 6.20.
NDIS imposta il membro Size su NDIS_SIZEOF_BIND_PARAMETERS_REVISION_3.
NDIS_BIND_PARAMETERS_REVISION_2
Aggiunto il membro HDSplitCurrentConfig per NDIS 6.1.
NDIS imposta il membro Size su NDIS_SIZEOF_BIND_PARAMETERS_REVISION_2.
NDIS_BIND_PARAMETERS_REVISION_1
Versione originale per NDIS 6.0.
NDIS imposta il membro Size su NDIS_SIZEOF_BIND_PARAMETERS_REVISION_1.
ProtocolSection
Puntatore a una stringa Unicode che contiene un percorso del Registro di sistema. Il percorso inizia dalla chiave di servizio del driver del protocollo e continua la gerarchia del Registro di sistema al nome dell'adattatore miniport (ad esempio Tcpip\Parameters\Adapters\<miniport adapter name>). Il nome dell'adattatore miniport è il nome dell'adattatore miniport più basso nello stack di driver. Se nello stack è presente un driver intermedio MUX, l'adattatore miniport più basso è un miniport virtuale. In caso contrario, l'adattatore miniport più basso è un adattatore miniport per un dispositivo fisico.
Il driver di protocollo può usare questo percorso del Registro di sistema per leggere i parametri di configurazione specifici dell'associazione tra il driver e l'adattatore miniport sottostante.
AdapterName
Puntatore a una stringa Unicode contenente il nome dell'adattatore miniport sottostante a cui deve essere associato ProtocolBindAdapterEx .
PhysicalDeviceObject
Oggetto dispositivo fisico per l'adattatore miniport sottostante.
MediaType
Tipo NdisMediumXxx supportato dall'adattatore miniport sottostante. Per altre informazioni sui tipi NdisMediumXxx , vedere NDIS_MEDIUM.
MtuSize
Dimensione massima dell'unità di trasferimento (MTU). Per altre informazioni, vedere OID_GEN_MAXIMUM_FRAME_SIZE.
MaxXmitLinkSpeed
Velocità massima del collegamento di trasmissione dell'adattatore sottostante in bit al secondo. Per altre informazioni, vedere OID_GEN_MAX_LINK_SPEED.
XmitLinkSpeed
Velocità del collegamento di trasmissione corrente dell'adattatore sottostante in bit al secondo. Per altre informazioni, vedere OID_GEN_LINK_SPEED_EX.
MaxRcvLinkSpeed
Velocità massima del collegamento di ricezione dell'adattatore sottostante in bit al secondo. Per altre informazioni, vedere OID_GEN_MAX_LINK_SPEED.
RcvLinkSpeed
Velocità di collegamento di ricezione corrente dell'adattatore sottostante in bit al secondo. Per altre informazioni, vedere OID_GEN_LINK_SPEED_EX.
MediaConnectState
Stato di connessione multimediale per l'adattatore miniport sottostante. Per ulteriori informazioni, vedere OID_GEN_MEDIA_CONNECT_STATUS_EX.
MediaDuplexState
Stato duplex multimediale per l'adattatore miniport sottostante. Per altre informazioni, vedere OID_GEN_MEDIA_DUPLEX_STATE.
LookaheadSize
Dimensioni lookahead per l'adattatore miniport sottostante. Per altre informazioni, vedere OID_GEN_CURRENT_LOOKAHEAD.
PowerManagementCapabilities
Funzionalità Plug and Play dell'adattatore miniport sottostante. Per altre informazioni, vedere OID_PNP_CAPABILITIES. I driver NDIS 6.20 e versioni successive devono usare invece il membro PowerManagementCapabilitiesEx .
SupportedPacketFilters
Set di flag che identificano i tipi di pacchetti di rete che la scheda miniport sottostante può filtrare.
MaxMulticastListSize
Dimensioni dell'elenco di indirizzi multicast per l'adattatore miniport sottostante. Per ulteriori informazioni, vedere OID_802_3_MAXIMUM_LIST_SIZE.
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.
PhysicalMediumType
Tipo di supporto fisico per l'adattatore miniport. Per altre informazioni, vedere OID_GEN_PHYSICAL_MEDIUM.
RcvScaleCapabilities
Funzionalità rss (Receive Side Scaling) della scheda di interfaccia di rete. Per ulteriori informazioni, vedere OID_GEN_RECEIVE_SCALE_CAPABILITIES.
BoundIfNetluid
Il valore NDIS NET_LUID , ovvero anche il nome dell'interfaccia di rete ( ifName in RFC 2863), dell'interfaccia di livello più alto in pila sulla scheda miniport. Ovvero, se sono presenti miniport virtuali o moduli di filtro installati tramite l'adattatore miniport, questo è il valore NET_LUID del miniport virtuale di livello più alto o modulo di filtro.
BoundIfIndex
Indice dell'interfaccia di rete NDIS dell'interfaccia di livello più alto in pila sulla scheda miniport. Ovvero, se sono presenti miniport virtuali o moduli di filtro installati tramite l'adattatore miniport, questo è l'ifIndex del miniport virtuale di livello più alto o modulo di filtro.
LowestIfNetluid
Il valore NDIS NET_LUID , ovvero anche il nome dell'interfaccia di rete ( ifName in RFC 2863), dell'interfaccia di livello più basso in un'associazione. Ovvero, l'interfaccia di rete NDIS della scheda miniport nella parte inferiore di uno stack di filtri.
LowestIfIndex
Indice dell'interfaccia di rete NDIS dell'interfaccia di livello più basso in un'associazione. Ovvero, l'interfaccia di rete NDIS della scheda miniport nella parte inferiore di uno stack di filtri.
AccessType
Tipo di accesso all'interfaccia di rete NDIS NET_IF_ACCESS_TYPE.
DirectionType
Tipo di direzione dell'interfaccia di rete NDIS NET_IF_DIRECTION_TYPE.
ConnectionType
Tipo di connessione dell'interfaccia di rete NDIS. Usare NET_IF_CONNECTION_DEDICATED per una tipica scheda Ethernet. I valori seguenti sono validi:
NET_IF_CONNECTION_DEDICATED
Specifica il tipo di connessione dedicato. La connessione viene generata automaticamente quando il rilevamento multimediale è TRUE. Ad esempio, una connessione Ethernet è dedicata.
NET_IF_CONNECTION_PASSIVE
Specifica il tipo di connessione passiva. L'altra estremità deve portare la connessione alla stazione locale. Ad esempio, l'interfaccia RAS è passiva.
NET_IF_CONNECTION_DEMAND
Specifica il tipo di connessione a richiesta. Una connessione con chiamata alla richiesta viene visualizzata in risposta a un'azione locale, ad esempio l'invio di un pacchetto.
IfType
Tipo di interfaccia IANA (Internet Assigned Numbers Authority). Ad esempio, IF_TYPE_ETHERNET_CSMACD (6) è il valore di IfType assegnato a qualsiasi interfaccia simile a Ethernet. Per un elenco se i tipi di interfaccia, vedere Tipi di interfaccia NDIS.
IfConnectorPresent
Valore booleano che indica se è presente un connettore. NDIS imposta questo valore su TRUE se è presente una scheda fisica.
ActivePorts
Da determinare.
DataBackFillSize
Dimensioni del riempimento dei dati necessarie, in byte, dello stack di driver sottostante.
ContextBackFillSize
Dimensione del backfill del contesto necessaria, in byte, dello stack di driver sottostante.
MacOptions
Opzioni MAC per l'adattatore miniport. Per altre informazioni, vedere OID_GEN_MAC_OPTIONS.
CompartmentId
Compartimento a cui appartiene l'interfaccia sottostante o uno dei valori seguenti:
NET_IF_COMPARTMENT_ID_UNSPECIFIED
Specifica che l'identificatore del compartimento non viene usato o specificato.
NET_IF_COMPARTMENT_ID_PRIMARY
Specifica l'identificatore predefinito del raggruppamento. I provider di interfacce di terze parti devono sempre specificare NET_IF_COMPARTMENT_ID_PRIMARY. Tutti gli altri valori sono riservati all'uso interno di Microsoft.
DefaultOffloadConfiguration
Puntatore a una struttura NDIS_OFFLOAD . Questa struttura specifica le funzionalità per un adattatore miniport compatibile con attività. Per ulteriori informazioni, vedere OID_TCP_OFFLOAD_CURRENT_CONFIG.
TcpConnectionOffloadCapabilities
Puntatore a un oggetto NDIS_TCP_CONNECTION_OFFLOAD struttura che indica le funzionalità di offload correnti fornite dall'adattatore miniport sottostante.
BoundAdapterName
Puntatore a una stringa Unicode contenente il nome dell'adattatore miniport di livello più alto in pila sull'adattatore miniport sottostante. Vale a dire, se sono presenti miniport virtuali del driver intermedio di filtro installati sulla scheda miniport, questo membro è il nome del miniport virtuale del driver intermedio di filtro di livello più alto.
HDSplitCurrentConfig
Puntatore a un oggetto NDIS_HD_SPLIT_CURRENT_CONFIG struttura. Questa struttura specifica la configurazione di suddivisione dei dati di intestazione corrente dell'adattatore miniport sottostante. Questo valore può essere NULL se l'adattatore miniport non supporta la suddivisione 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.
PowerManagementCapabilitiesEx
Puntatore a una struttura NDIS_PM_CAPABILITIES . Questa struttura specifica le funzionalità di risparmio energia dell'adattatore miniport. Questo membro è obbligatorio per i driver NDIS 6.20 e versioni successive.
NicSwitchCapabilities
Puntatore a un oggetto NDIS_NIC_SWITCH_CAPABILITIES struttura. Questa struttura specifica le funzionalità del commutatore 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.
NDKEnabled
NDIS imposta questo valore su TRUE se l'interfaccia del provider del kernel diretto di rete (NDKPI) è attualmente abilitata nella scheda miniport sottostante.
NDKCapabilities
Puntatore a una struttura NDIS_NDK_CAPABILITIES . Questa struttura specifica le funzionalità ND KPI attualmente abilitate nell'adattatore miniport sottostante. Questo valore può essere NULL se l'adattatore miniport non supporta l'indicatore KPI ND.
SriovCapabilities
Puntatore a una struttura NDIS_SRIOV_CAPABILITIES . Questa struttura specifica le funzionalità di virtualizzazione I/O (SR-IOV) singole attualmente abilitate nell'adattatore miniport sottostante. Questo valore può essere NULL se l'adattatore miniport non supporta le funzionalità SR-IOV.
NicSwitchArray
Puntatore a una struttura di NDIS_NIC_SWITCH_INFO_ARRAY . Questa matrice enumera le opzioni di interfaccia 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.
Commenti
NDIS passa un puntatore a una struttura NDIS_BIND_PARAMETERS nel parametro BindParameters dell'oggetto Funzione ProtocolBindAdapterEx .
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Supportato in NDIS 6.0 e versioni successive. |
| Intestazione | ndis.h (includere Ndis.h) |
Vedi anche
NDIS_RECEIVE_FILTER_CAPABILITIESOID_GEN_MEDIA_CONNECT_STATUS_EX
OID_GEN_RECEIVE_SCALE_CAPABILITIES