NDIS_BIND_PARAMETERS Struktur (ndis.h)
NDIS initialisiert eine NDIS_BIND_PARAMETERS Struktur mit Informationen, die die Eigenschaften einer Bindung definieren und an einen Protokolltreiber übergeben.
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;
Angehörige
Header
Die NDIS_OBJECT_HEADER Struktur für die NDIS_BIND_PARAMETERS Struktur. NDIS legt das element Type der Struktur fest, das Header- angibt, NDIS_OBJECT_TYPE_BIND_PARAMETERS.
Um die Version der NDIS_BIND_PARAMETERS Struktur anzugeben, legt NDIS das element Revision auf einen der folgenden Werte fest:
NDIS_BIND_PARAMETERS_REVISION_4
Verschiedene Mitglieder für NDIS 6.30 hinzugefügt.
NDIS legt den Size Member auf NDIS_SIZEOF_BIND_PARAMETERS_REVISION_4 fest.
NDIS_BIND_PARAMETERS_REVISION_3
Die ReceiveFilterCapabilities, PowerManagementCapabilitiesExund NicSwitchCapabilities Member für NDIS 6.20 hinzugefügt.
NDIS legt das element Size auf NDIS_SIZEOF_BIND_PARAMETERS_REVISION_3 fest.
NDIS_BIND_PARAMETERS_REVISION_2
Das HDSplitCurrentConfig Mitglied für NDIS 6.1 wurde hinzugefügt.
NDIS legt den Size Member auf NDIS_SIZEOF_BIND_PARAMETERS_REVISION_2 fest.
NDIS_BIND_PARAMETERS_REVISION_1
Originalversion für NDIS 6.0.
NDIS legt den Size Member auf NDIS_SIZEOF_BIND_PARAMETERS_REVISION_1 fest.
ProtocolSection
Ein Zeiger auf eine Unicode-Zeichenfolge, die einen Registrierungspfad enthält. Der Pfad beginnt vom Dienstschlüssel des Protokolltreibers und setzt die Registrierungshierarchie bis zum Namen des Miniportadapters fort (z. B. Tcpip\Parameters\Adapters\<miniport adapter name>). Der Name des Miniportadapters ist der Name des untersten Miniportadapters im Treiberstapel. Wenn ein MUX-Zwischentreiber im Stapel 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 physische Geräteobjekt für den zugrunde liegenden Miniportadapter.
MediaType
Der NdisMediumXxx Typ, den der zugrunde liegende Miniportadapter unterstützt. Weitere Informationen zu NdisMediumXxx--Typen finden Sie unter NDIS_MEDIUM.
MtuSize
Die maximale Übertragungseinheitsgröße (MTU). Weitere Informationen finden Sie unter OID_GEN_MAXIMUM_FRAME_SIZE.
MaxXmitLinkSpeed
Die maximale Übertragungsverbindungsgeschwindigkeit des zugrunde liegenden Adapters in Bits pro Sekunde. Weitere Informationen finden Sie unter OID_GEN_MAX_LINK_SPEED.
XmitLinkSpeed
Die aktuelle Übertragungsverbindungsgeschwindigkeit des zugrunde liegenden Adapters in Bits pro Sekunde. Weitere Informationen finden Sie unter OID_GEN_LINK_SPEED_EX.
MaxRcvLinkSpeed
Die maximale Empfangsverbindungsgeschwindigkeit des zugrunde liegenden Adapters in Bits pro Sekunde. Weitere Informationen finden Sie unter OID_GEN_MAX_LINK_SPEED.
RcvLinkSpeed
Die aktuelle Verbindungsgeschwindigkeit 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 Medienduplexstatus 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-and-Play-Funktionen des zugrunde liegenden Miniportadapters. Weitere Informationen finden Sie unter OID_PNP_CAPABILITIES. Stattdessen müssen NDIS 6.20 und höhere Treiber das PowerManagementCapabilitiesEx Member verwenden.
SupportedPacketFilters
Eine Reihe von Flags, die die Typen von Netzwerkpaketen identifizieren, die der zugrunde liegende Miniportadapter filtern kann.
MaxMulticastListSize
Die Multicast-Adresslistengröße für den zugrunde liegenden Miniportadapter. Weitere Informationen finden Sie unter OID_802_3_MAXIMUM_LIST_SIZE.
MacAddressLength
Die LÄNGE der MAC-Adresse in Byte. Die MAC-Adresslänge ist spezifisch für den Medientyp.
CurrentMacAddress[NDIS_MAX_PHYS_ADDRESS_LENGTH]
Die aktuelle MAC-Adresse. Beispielsweise gibt das OID_802_3_CURRENT_ADDRESS OID die aktuelle MAC-Adresse für IEEE 802.3-Treiber an.
PhysicalMediumType
Der physische Mitteltyp für den Miniportadapter. Weitere Informationen finden Sie unter OID_GEN_PHYSICAL_MEDIUM.
RcvScaleCapabilities
Die die Seitenskalierung (RSS) Funktionen der NIC empfangen. Weitere Informationen finden Sie unter OID_GEN_RECEIVE_SCALE_CAPABILITIES.
BoundIfNetluid
Der NDIS-NET_LUID-Wert, d. h. der Name der Netzwerkschnittstelle ( ifName in RFC 2863), der schnittstelle der höchsten Ebene, die auf dem Miniportadapter gestapelt ist. Wenn es virtuelle Miniports oder Filtermodule gibt, die über den Miniportadapter installiert sind, ist dies der NET_LUID Wert des virtuellen Miniports oder Filtermoduls der höchsten 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 sind, ist dies der ifIndex des virtuellen Miniports oder Filtermoduls der höchsten Ebene.
LowestIfNetluid
Der NDIS-NET_LUID-Wert, d. h. der Name der Netzwerkschnittstelle ( ifName in RFC 2863), der Schnittstelle der niedrigsten Ebene für eine Bindung. 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. Die folgenden Werte sind gültig:
NET_IF_CONNECTION_DEDICATED
Gibt den dedizierten Verbindungstyp an. Die Verbindung wird automatisch angezeigt, wenn der Mediensinn TRUEist. Beispielsweise ist eine Ethernet-Verbindung dedizierte.
NET_IF_CONNECTION_PASSIVE
Gibt den passiven Verbindungstyp an. Das andere Ende muss die Verbindung mit dem lokalen Bahnhof herstellen. Die RAS-Schnittstelle ist z. B. passiv.
NET_IF_CONNECTION_DEMAND
Gibt den Verbindungstyp für Die Bedarfswählverbindung an. Eine Bedarfswählverbindung tritt als Reaktion auf eine lokale Aktion auf, z. B. das Senden eines Pakets.
IfType
Der Schnittstellentyp Internet Assigned Numbers Authority (IANA). Beispielsweise ist IF_TYPE_ETHERNET_CSMACD (6) der Wert für IfType-, der einer beliebigen Ethernet-ähnlichen Schnittstelle zugewiesen ist. Eine Liste, wenn Schnittstellentypen vorhanden sind, 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
Bestimmt werden soll.
DataBackFillSize
Die erforderliche Datenrückfüllgröße (in Byte) des zugrunde liegenden Treiberstapels.
ContextBackFillSize
Die erforderliche Größe des Kontextrückfüllbereichs (in Bytes) des zugrunde liegenden Treiberstapels.
MacOptions
Die MAC-Optionen für den Miniportadapter. Weitere Informationen finden Sie unter OID_GEN_MAC_OPTIONS.
CompartmentId
Das Abteil, zu dem die zugrunde liegende Schnittstelle gehört, oder eines der folgenden Werte:
NET_IF_COMPARTMENT_ID_UNSPECIFIED
Gibt an, dass der Fachbezeichner nicht verwendet oder angegeben wird.
NET_IF_COMPARTMENT_ID_PRIMARY
Gibt den Standardfachbezeichner an. Schnittstellenanbieter von Drittanbietern 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-offloadfä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 Offload-Funktionen 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 Filter-Zwischentreibers vorhanden sind, die über den Miniportadapter installiert sind, ist dieses Mitglied der Name des virtuellen Miniports des virtuellen Zwischentreibers auf höchster Ebene.
HDSplitCurrentConfig
Ein Zeiger auf einen NDIS_HD_SPLIT_CURRENT_CONFIG Struktur. Diese Struktur gibt die aktuelle Geteilte Konfiguration der Headerdaten des zugrunde liegenden Miniportadapters an. Dieser Wert kann NULL- werden, wenn der Miniportadapter keine Headerdatenteilung unterstützt.
ReceiveFilterCapabilities
Ein Zeiger auf einen NDIS_RECEIVE_FILTER_CAPABILITIES Struktur. Diese Struktur gibt die generischen Filterfunktionen an, die derzeit auf dem zugrunde liegenden Miniportadapter aktiviert sind. Dieser Wert kann NULL- werden, wenn der Miniportadapter keine Empfangsfilterung unterstützt.
PowerManagementCapabilitiesEx
Ein Zeiger auf eine NDIS_PM_CAPABILITIES Struktur. Diese Struktur gibt die Leistungsverwaltungsfunktionen des Miniportadapters an. Dieses Mitglied ist für NDIS 6.20 und höhere Treiber obligatorisch.
NicSwitchCapabilities
Ein Zeiger auf einen NDIS_NIC_SWITCH_CAPABILITIES Struktur. Diese Struktur gibt die NIC-Switchfunktionen des zugrunde liegenden Miniportadapters an. Dieser Wert kann NULL- werden, wenn der Miniportadapter keine NIC-Switch-Features unterstützt.
NDKEnabled
NDIS legt diesen Wert auf TRUE fest, wenn die NDKPI (Network Direct Kernel Provider Interface) derzeit auf dem zugrunde liegenden Miniportadapter aktiviert ist.
NDKCapabilities
Ein Zeiger auf eine NDIS_NDK_CAPABILITIES Struktur. Diese Struktur gibt die NDKPI-Funktionen an, die derzeit auf dem zugrunde liegenden Miniportadapter aktiviert sind. Dieser Wert kann NULL- werden, wenn der Miniportadapter NDKPI nicht unterstützt.
SriovCapabilities
Ein Zeiger auf eine NDIS_SRIOV_CAPABILITIES Struktur. Diese Struktur gibt die Funktionen der einzelnen Stamm-E/A-Virtualisierung (SR-IOV) an, die derzeit auf dem zugrunde liegenden Miniportadapter aktiviert sind. Dieser Wert kann NULL- werden, wenn der Miniportadapter SR-IOV Features nicht 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-Schalter können nur erstellt werden, wenn SR-IOV unterstützt und auf dem Adapter aktiviert ist.
Bemerkungen
NDIS übergibt einen Zeiger an eine NDIS_BIND_PARAMETERS Struktur im BindParameters Parameter des Parameters ProtocolBindAdapterEx Funktion.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Unterstützt in NDIS 6.0 und höher. |
| Header- | ndis.h (include Ndis.h) |
Siehe auch
NDIS_RECEIVE_FILTER_CAPABILITIESOID_GEN_MEDIA_CONNECT_STATUS_EX
OID_GEN_RECEIVE_SCALE_CAPABILITIES