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. Per ulteriori informazioni, vedere OID_GEN_SUPPORTED_PACKET_FILTERS.

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. Il valore seguente è valido:

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

Raggruppamento a cui appartiene l'interfaccia sottostante o uno dei valori seguenti:

NET_IF_COMPARTMENT_ID_UNSPECIFIED

Specifica che l'identificatore del raggruppamento non viene utilizzato 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 per l'uso interno di Microsoft.

DefaultOffloadConfiguration

Puntatore a una struttura NDIS_OFFLOAD . Questa struttura specifica le funzionalità per un adattatore miniport con supporto per task-offload. 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 che contiene il nome dell'adattatore miniport di livello più alto in pila sull'adattatore miniport sottostante. Ovvero, se sono presenti miniport virtuali del driver intermedio di filtro installati tramite l'adattatore 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 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.

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 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.

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à NDKPI attualmente abilitate nell'adattatore miniport sottostante. Questo valore può essere NULL se l'adattatore miniport non supporta NDKPI.

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.

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 nell'adattatore.

Nota A partire da Windows Server 2012, Windows supporta solo l'opzione di interfaccia di rete predefinita nell'adattatore miniport. Pertanto, questa matrice può contenere un solo elemento.
 

Commenti

NDIS passa un puntatore a una struttura NDIS_BIND_PARAMETERS nel parametro BindParameters di Funzione ProtocolBindAdapterEx .

Requisiti

   
Client minimo supportato Supportato in NDIS 6.0 e versioni successive.
Intestazione ndis.h (include Ndis.h)

Vedi anche

NDIS_HD_SPLIT_CURRENT_CONFIG

NDIS_MEDIUM

NDIS_NIC_SWITCH_CAPABILITIES

NDIS_NIC_SWITCH_INFO_ARRAY

NDIS_OBJECT_HEADER

NDIS_OFFLOAD

NDIS_PM_CAPABILITIES

NDIS_RECEIVE_FILTER_CAPABILITIES

NDIS_SRIOV_CAPABILITIES

NDIS_TCP_CONNECTION_OFFLOAD

NET_IF_ACCESS_TYPE

NET_IF_DIRECTION_TYPE

NET_LUID

OID_802_3_CURRENT_ADDRESS

OID_802_3_MAXIMUM_LIST_SIZE

OID_802_3_PERMANENT_ADDRESS

OID_GEN_CURRENT_LOOKAHEAD

OID_GEN_LINK_SPEED_EX

OID_GEN_MAC_OPTIONS

OID_GEN_MAXIMUM_FRAME_SIZE

OID_GEN_MAX_LINK_SPEED

OID_GEN_MEDIA_CONNECT_STATUS_EX

OID_GEN_MEDIA_DUPLEX_STATE

OID_GEN_PHYSICAL_MEDIUM

OID_GEN_RECEIVE_SCALE_CAPABILITIES OID_GEN_SUPPORTED_PACKET_FILTERS

OID_PNP_CAPABILITIES

OID_TCP_OFFLOAD_CURRENT_CONFIG

ProtocolBindAdapterEx