Freigeben über


NDIS_BIND_PARAMETERS-Struktur (ndis.h)

NDIS initialisiert eine NDIS_BIND_PARAMETERS-Struktur mit Informationen, die die Merkmale einer Bindung definieren, und übergibt sie an einen Protokolltreiber.

Syntax

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;

Member

Header

Die NDIS_OBJECT_HEADER-Struktur für die NDIS_BIND_PARAMETERS-Struktur . NDIS legt den Typmember der Struktur, die Header angibt, auf NDIS_OBJECT_TYPE_BIND_PARAMETERS fest.

Um die Version der NDIS_BIND_PARAMETERS-Struktur anzugeben, legt NDIS den Revisionsmember auf einen der folgenden Werte fest:

NDIS_BIND_PARAMETERS_REVISION_4

Verschiedene Member für NDIS 6.30 hinzugefügt.

NDIS legt das Element Größe auf NDIS_SIZEOF_BIND_PARAMETERS_REVISION_4 fest.

NDIS_BIND_PARAMETERS_REVISION_3

Die Member ReceiveFilterCapabilities, PowerManagementCapabilitiesEx und NicSwitchCapabilities für NDIS 6.20 wurden hinzugefügt.

NDIS legt das Element Größe auf NDIS_SIZEOF_BIND_PARAMETERS_REVISION_3 fest.

NDIS_BIND_PARAMETERS_REVISION_2

Das HDSplitCurrentConfig-Element für NDIS 6.1 wurde hinzugefügt.

NDIS legt das Element Größe auf NDIS_SIZEOF_BIND_PARAMETERS_REVISION_2 fest.

NDIS_BIND_PARAMETERS_REVISION_1

Originalversion für NDIS 6.0.

NDIS legt das Element Größe auf NDIS_SIZEOF_BIND_PARAMETERS_REVISION_1 fest.

ProtocolSection

Ein Zeiger auf eine Unicode-Zeichenfolge, die einen Registrierungspfad enthält. Der Pfad beginnt mit dem Dienstschlüssel des Protokolltreibers und fährt in der Registrierungshierarchie weiter unten zum Namen des Miniportadapters (z. B. Tcpip\Parameters\Adapters\<miniport adapter name>). Der Name des Miniportadapters ist der Name des untersten Miniportadapters im Treiberstapel. Wenn im Stapel ein MUX-Zwischentreiber vorhanden ist, ist der unterste Miniportadapter ein virtueller Miniport. Andernfalls ist der unterste Miniportadapter ein Miniportadapter für ein physisches Gerät.

Der Protokolltreiber kann diesen Registrierungspfad verwenden, um Konfigurationsparameter zu lesen, die für die Bindung zwischen dem Treiber und dem zugrunde liegenden Miniportadapter spezifisch sind.

AdapterName

Ein Zeiger auf eine Unicode-Zeichenfolge, die den Namen des zugrunde liegenden Miniportadapters enthält, an den ProtocolBindAdapterEx gebunden werden soll.

PhysicalDeviceObject

Das objekt des physischen Geräts für den zugrunde liegenden Miniportadapter.

MediaType

Der NdisMediumXxx-Typ , den der zugrunde liegende Miniportadapter unterstützt. Weitere Informationen zu Xxx-Typen von NdisMedium finden Sie unter NDIS_MEDIUM.

MtuSize

Die maximale MTU-Größe (Transfer Unit). Weitere Informationen finden Sie unter OID_GEN_MAXIMUM_FRAME_SIZE.

MaxXmitLinkSpeed

Die maximale Übertragungslinkgeschwindigkeit des zugrunde liegenden Adapters in Bits pro Sekunde. Weitere Informationen finden Sie unter OID_GEN_MAX_LINK_SPEED.

XmitLinkSpeed

Die aktuelle Übertragungslinkgeschwindigkeit des zugrunde liegenden Adapters in Bits pro Sekunde. Weitere Informationen finden Sie unter OID_GEN_LINK_SPEED_EX.

MaxRcvLinkSpeed

Die maximale Empfangslinkgeschwindigkeit des zugrunde liegenden Adapters in Bits pro Sekunde. Weitere Informationen finden Sie unter OID_GEN_MAX_LINK_SPEED.

RcvLinkSpeed

Die aktuelle Empfangslinkgeschwindigkeit des zugrunde liegenden Adapters in Bits pro Sekunde. Weitere Informationen finden Sie unter OID_GEN_LINK_SPEED_EX.

MediaConnectState

Der Medienverbindungsstatus für den zugrunde liegenden Miniportadapter. Weitere Informationen finden Sie unter OID_GEN_MEDIA_CONNECT_STATUS_EX.

MediaDuplexState

Der Medienduplexzustand für den zugrunde liegenden Miniportadapter. Weitere Informationen finden Sie unter OID_GEN_MEDIA_DUPLEX_STATE.

LookaheadSize

Die Lookaheadgröße für den zugrunde liegenden Miniportadapter. Weitere Informationen finden Sie unter OID_GEN_CURRENT_LOOKAHEAD.

PowerManagementCapabilities

Die Plug & Play Funktionen des zugrunde liegenden Miniportadapters. Weitere Informationen finden Sie unter OID_PNP_CAPABILITIES. Treiber von NDIS 6.20 und höher müssen stattdessen das PowerManagementCapabilitiesEx-Element verwenden.

SupportedPacketFilters

Eine Reihe von Flags, die die Typen von Netzwerkpaketen identifizieren, die der zugrunde liegende Miniportadapter filtern kann.

MaxMulticastListSize

Die Multicastadresslistengröße für den zugrunde liegenden Miniportadapter. Weitere Informationen finden Sie unter OID_802_3_MAXIMUM_LIST_SIZE.

MacAddressLength

Die MAC-Adresslänge in Bytes. Die MAC-Adresslänge ist spezifisch für den Medientyp.

CurrentMacAddress[NDIS_MAX_PHYS_ADDRESS_LENGTH]

Die aktuelle MAC-Adresse. Beispielsweise gibt die OID_802_3_CURRENT_ADDRESS OID die aktuelle MAC-Adresse für IEEE 802.3-Treiber an.

PhysicalMediumType

Der typ des physischen Mediums für den Miniportadapter. Weitere Informationen finden Sie unter OID_GEN_PHYSICAL_MEDIUM.

RcvScaleCapabilities

Die RSS-Funktionen (Receive Side Scaling) der NIC. Weitere Informationen finden Sie unter OID_GEN_RECEIVE_SCALE_CAPABILITIES.

BoundIfNetluid

Der NDIS-NET_LUID Wert, der auch der Name der Netzwerkschnittstelle ( ifName in RFC 2863) der Schnittstelle der obersten Ebene ist, die auf dem Miniportadapter gestapelt ist. Das heißt, wenn virtuelle Miniports oder Filtermodule über den Miniportadapter installiert werden, ist dies der NET_LUID Wert des virtuellen Miniports oder Filtermoduls der obersten Ebene.

BoundIfIndex

Der NDIS-Netzwerkschnittstellenindex der Schnittstelle der höchsten Ebene, die auf dem Miniportadapter gestapelt ist. Das heißt, wenn virtuelle Miniports oder Filtermodule über den Miniportadapter installiert werden, ist dies der ifIndex des virtuellen Miniport- oder Filtermoduls der obersten Ebene.

LowestIfNetluid

Der NDIS NET_LUID Wert, der auch der Name der Netzwerkschnittstelle ( ifName in RFC 2863) der Schnittstelle der niedrigsten Ebene für eine Bindung ist. Das heißt, die NDIS-Netzwerkschnittstelle des Miniportadapters am unteren Rand eines Filterstapels.

LowestIfIndex

Der NDIS-Netzwerkschnittstellenindex der Schnittstelle der niedrigsten Ebene für eine Bindung. Das heißt, die NDIS-Netzwerkschnittstelle des Miniportadapters am unteren Rand eines Filterstapels.

AccessType

Ein NET_IF_ACCESS_TYPE NDIS-Netzwerkschnittstellenzugriffstyp.

DirectionType

Ein NET_IF_DIRECTION_TYPE NDIS-Netzwerkschnittstellenrichtungstyp.

ConnectionType

Der NDIS-Netzwerkschnittstellenverbindungstyp. Verwenden Sie NET_IF_CONNECTION_DEDICATED für einen typischen Ethernet-Adapter. Folgende Werte sind gültig:

NET_IF_CONNECTION_DEDICATED

Gibt den dedizierten Verbindungstyp an. Die Verbindung wird automatisch hergestellt, wenn die Medienoptimierung AUF TRUE festgelegt ist. Beispielsweise ist eine Ethernet-Verbindung dediziert.

NET_IF_CONNECTION_PASSIVE

Gibt den passiven Verbindungstyp an. Das andere Ende muss die Verbindung zur lokalen Station herstellen. Beispielsweise ist die RAS-Schnittstelle passiv.

NET_IF_CONNECTION_DEMAND

Gibt den Verbindungstyp für die Bedarfswahl an. Als Reaktion auf eine lokale Aktion, z. B. beim Senden eines Pakets, wird eine Wählverbindung bei Bedarf hergestellt.

IfType

Der IANA-Schnittstellentyp (Internet Assigned Numbers Authority). Beispielsweise ist IF_TYPE_ETHERNET_CSMACD (6) der Wert für IfType , der jeder Ethernet-ähnlichen Schnittstelle zugewiesen ist. Eine Liste von Schnittstellentypen finden Sie unter NDIS-Schnittstellentypen.

IfConnectorPresent

Ein boolescher Wert, der angibt, ob ein Connector vorhanden ist. NDIS legt diesen Wert auf TRUE fest, wenn ein physischer Adapter vorhanden ist.

ActivePorts

Bestimmung erforderlich.

DataBackFillSize

Die erforderliche Datenbackfillgröße des zugrunde liegenden Treiberstapels in Byte.

ContextBackFillSize

Die erforderliche Kontextbackfillgröße des zugrunde liegenden Treiberstapels in Bytes.

MacOptions

Die MAC-Optionen für den Miniportadapter. Weitere Informationen finden Sie unter OID_GEN_MAC_OPTIONS.

CompartmentId

Das Fach, zu dem die zugrunde liegende Schnittstelle gehört, oder einer der folgenden Werte:

NET_IF_COMPARTMENT_ID_UNSPECIFIED

Gibt an, dass der Abteilbezeichner nicht verwendet oder angegeben wird.

NET_IF_COMPARTMENT_ID_PRIMARY

Gibt den Standardfachbezeichner an. Drittanbieter müssen immer NET_IF_COMPARTMENT_ID_PRIMARY angeben. Alle anderen Werte sind für die interne Verwendung von Microsoft reserviert.

DefaultOffloadConfiguration

Ein Zeiger auf eine NDIS_OFFLOAD-Struktur . Diese Struktur gibt die Funktionen für einen Task-Offload-fähigen Miniportadapter an. Weitere Informationen finden Sie unter OID_TCP_OFFLOAD_CURRENT_CONFIG.

TcpConnectionOffloadCapabilities

Ein Zeiger auf einen NDIS_TCP_CONNECTION_OFFLOAD Struktur, die die aktuellen Auslagerungsfunktionen angibt, die vom zugrunde liegenden Miniportadapter bereitgestellt werden.

BoundAdapterName

Ein Zeiger auf eine Unicode-Zeichenfolge, die den Namen des Miniportadapters der höchsten Ebene enthält, der auf dem zugrunde liegenden Miniportadapter gestapelt ist. Das heißt, wenn virtuelle Miniports des Filterzwerdertreibers über den Miniportadapter installiert sind, ist dieser Member der Name des virtuellen Miniports des höchsten Filter-Zwischentreibers.

HDSplitCurrentConfig

Ein Zeiger auf einen NDIS_HD_SPLIT_CURRENT_CONFIG Struktur. Diese Struktur gibt die aktuelle Header-Datenteilungskonfiguration des zugrunde liegenden Miniportadapters an. Dieser Wert kann NULL sein, wenn der Miniportadapter keine Header-Datenteilung unterstützt.

ReceiveFilterCapabilities

Ein Zeiger auf einen NDIS_RECEIVE_FILTER_CAPABILITIES Struktur. Diese Struktur gibt die generischen Filterfunktionen an, die derzeit für den zugrunde liegenden Miniportadapter aktiviert sind. Dieser Wert kann NULL sein, wenn der Miniportadapter keine Empfangsfilterung unterstützt.

PowerManagementCapabilitiesEx

Ein Zeiger auf eine NDIS_PM_CAPABILITIES-Struktur . Diese Struktur gibt die Energieverwaltungsfunktionen des Miniportadapters an. Dieses Element ist für NDIS 6.20- und höher-Treiber obligatorisch.

NicSwitchCapabilities

Ein Zeiger auf einen NDIS_NIC_SWITCH_CAPABILITIES Struktur. Diese Struktur gibt die NIC-Switch-Funktionen des zugrunde liegenden Miniportadapters an. Dieser Wert kann NULL sein, wenn der Miniportadapter keine NIC-Switch-Features unterstützt.

NDKEnabled

NDIS legt diesen Wert auf TRUE fest, wenn die Netzwerkschnittstelle des direkten Kernelanbieters (NDKPI) derzeit für den zugrunde liegenden Miniportadapter aktiviert ist.

NDKCapabilities

Ein Zeiger auf eine NDIS_NDK_CAPABILITIES Struktur. Diese Struktur gibt die NDKPI-Funktionen an, die derzeit für den zugrunde liegenden Miniportadapter aktiviert sind. Dieser Wert kann NULL sein, wenn der Miniportadapter NDKPI nicht unterstützt.

SriovCapabilities

Ein Zeiger auf eine NDIS_SRIOV_CAPABILITIES-Struktur . Diese Struktur gibt die Funktionen der Einzelstamm-E/A-Virtualisierung (Single Root E/O Virtualization, SR-IOV) an, die derzeit für den zugrunde liegenden Miniportadapter aktiviert sind. Dieser Wert kann NULL sein, wenn der Miniportadapter keine SR-IOV-Features unterstützt.

NicSwitchArray

Ein Zeiger auf eine NDIS_NIC_SWITCH_INFO_ARRAY-Struktur . Dieses Array listet die NIC-Switches auf, die auf dem Miniportadapter erstellt wurden. NIC-Switches können nur erstellt werden, wenn SR-IOV auf dem Adapter unterstützt und aktiviert wird.

Hinweis Ab Windows Server 2012 unterstützt Windows nur den Standard-NIC-Schalter auf dem Miniportadapter. Daher kann dieses Array nur ein Element enthalten.
 

Hinweise

NDIS übergibt einen Zeiger an eine NDIS_BIND_PARAMETERS-Struktur im BindParameters-Parameter des ProtocolBindAdapterEx-Funktion .

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Unterstützt in NDIS 6.0 und höher.
Kopfzeile ndis.h (einschließlich Ndis.h)

Weitere Informationen

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_PNP_CAPABILITIES

OID_TCP_OFFLOAD_CURRENT_CONFIG

ProtocolBindAdapterEx