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.
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_RECEIVE_FILTER_CAPABILITIESOID_GEN_MEDIA_CONNECT_STATUS_EX
OID_GEN_RECEIVE_SCALE_CAPABILITIESFeedback
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter https://aka.ms/ContentUserFeedback.
Feedback senden und anzeigen für