NDIS_FILTER_ATTACH_PARAMETERS-Struktur (ndis.h)

Artikel
08/07/2023

Die NDIS_FILTER_ATTACH_PARAMETERS-Struktur definiert die Initialisierungsparameter für das Filtermodul.

Syntax

typedef struct _NDIS_FILTER_ATTACH_PARAMETERS {
  NDIS_OBJECT_HEADER                Header;
  NET_IFINDEX                       IfIndex;
  NET_LUID                          NetLuid;
  PNDIS_STRING                      FilterModuleGuidName;
  NET_IFINDEX                       BaseMiniportIfIndex;
  PNDIS_STRING                      BaseMiniportInstanceName;
  PNDIS_STRING                      BaseMiniportName;
  NDIS_MEDIA_CONNECT_STATE          MediaConnectState;
  NET_IF_MEDIA_DUPLEX_STATE         MediaDuplexState;
  ULONG64                           XmitLinkSpeed;
  ULONG64                           RcvLinkSpeed;
  NDIS_MEDIUM                       MiniportMediaType;
  NDIS_PHYSICAL_MEDIUM              MiniportPhysicalMediaType;
  NDIS_HANDLE                       MiniportMediaSpecificAttributes;
  PNDIS_OFFLOAD                     DefaultOffloadConfiguration;
  USHORT                            MacAddressLength;
  UCHAR                             CurrentMacAddress[NDIS_MAX_PHYS_ADDRESS_LENGTH];
  NET_LUID                          BaseMiniportNetLuid;
  NET_IFINDEX                       LowerIfIndex;
  NET_LUID                          LowerIfNetLuid;
  ULONG                             Flags;
  PNDIS_HD_SPLIT_CURRENT_CONFIG     HDSplitCurrentConfig;
  PNDIS_RECEIVE_FILTER_CAPABILITIES ReceiveFilterCapabilities;
  PDEVICE_OBJECT                    MiniportPhysicalDeviceObject;
  PNDIS_NIC_SWITCH_CAPABILITIES     NicSwitchCapabilities;
  BOOLEAN                           BaseMiniportIfConnectorPresent;
  PNDIS_SRIOV_CAPABILITIES          SriovCapabilities;
  PNDIS_NIC_SWITCH_INFO_ARRAY       NicSwitchArray;
} NDIS_FILTER_ATTACH_PARAMETERS, *PNDIS_FILTER_ATTACH_PARAMETERS;

Member

Header

Die NDIS_OBJECT_HEADER-Struktur für die NDIS_FILTER_ATTACH_PARAMETERS-Struktur . NDIS legt den Type-Member der Struktur fest, die Header angibt, um NDIS_OBJECT_TYPE_FILTER_ATTACH_PARAMETERS.

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

NDIS_FILTER_ATTACH__PARAMETERS_REVISION_4

Verschiedene Member für NDIS 6.30 hinzugefügt.

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

NDIS_FILTER_ATTACH_PARAMETERS_REVISION_3

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

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

NDIS_FILTER_ATTACH_PARAMETERS_REVISION_2

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

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

NDIS_FILTER_ATTACH_PARAMETERS_REVISION_1

Originalversion für NDIS 6.0.

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

IfIndex

Der NDIS-Schnittstellenindex des Filtermoduls, das NDIS an den Treiberstapel anfügt.

NetLuid

Die NDIS-Netzwerkschnittstelle NET_LUID Wert für das Filtermodul, das NDIS an den Treiberstapel anfügt. Die NET_LUID entspricht dem Schnittstellennamen (ifName in RFC 2863 ).

FilterModuleGuidName

Der GUID-Name des Filtermoduls, das von NDIS angefügt wird.

BaseMiniportIfIndex

Der NDIS-Netzwerkschnittstellenindex des Basis-Miniportadapters. Das heißt, wenn virtuelle Miniports oder Filtermodule über einen physischen Miniportadapter installiert werden, ist der Wert dieses Members der Schnittstellenindex des physischen Miniportadapters oder ein virtueller Miniport des MUX-Zwischentreibers der obersten Ebene.

BaseMiniportInstanceName

Ein Zeiger auf einen NDIS_STRING Typwert, der eine gezählte Unicode-Zeichenfolge enthält. Diese Zeichenfolge gibt den Anzeigenamen der Schnittstelle für den Basis-Miniportadapter an. Für Windows 2000 und höhere Versionen definiert NDIS den NDIS_STRING-Typ als UNICODE_STRING Typ.

BaseMiniportName

Der Name des Basis-Miniportadapters.

MediaConnectState

The NET_IF_MEDIA_CONNECT_STATE Verbindungszustandstyp.

MediaDuplexState

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

XmitLinkSpeed

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

RcvLinkSpeed

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

MiniportMediaType

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

MiniportPhysicalMediaType

Der physische Mediumtyp für den zugrunde liegenden Miniportadapter. Weitere Informationen finden Sie unter OID_GEN_PHYSICAL_MEDIUM.

MiniportMediaSpecificAttributes

Ein Zeiger auf eine NDIS_OBJECT_HEADER Struktur, die eine Struktur identifiziert, die medienspezifische Miniportattribute enthält, oder NULL , wenn keine solchen Attribute vorhanden sind. Der Type-Member der NDIS_OBJECT_HEADER-Struktur identifiziert den Typ der Attributstruktur. Wenn der Medientyp des zugrunde liegenden Miniportadapters beispielsweise NdisMediumNative802_11 ist, sollte das Type-Element NDIS_OBJECT_TYPE_MINIPORT_ADAPTER_NATIVE_802_11_ATTRIBUTES sein, und das MiniportMediaSpecificAttributes-Element verweist auf eine NDIS_MINIPORT_ADAPTER_NATIVE_802_11_ATTRIBUTES Struktur.

DefaultOffloadConfiguration

Ein Zeiger auf eine NDIS_OFFLOAD-Struktur , die Aufgabenauslagerungsattribute definiert. Der Filtertreiber sollte diese Attribute überprüfen, um die Aufgabenauslagerungsfunktionen der zugrunde liegenden Treiber abzurufen. Der Filtertreiber sollte diese Attribute bei Bedarf ändern, um alle erforderlichen Änderungen an der Unterstützung für die Aufgabenauslagerung widerzuspiegeln.

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.

BaseMiniportNetLuid

Die NDIS-Netzwerkschnittstelle NET_LUID des Basis-Miniportadapters. Das heißt, wenn virtuelle Miniports oder Filtermodule über einen physischen Miniportadapter installiert sind, ist der Wert dieses Members die NET_LUID des physischen Miniportadapters oder eines virtuellen Miniports des mux-Zwischentreibers der obersten Ebene.

LowerIfIndex

Der NDIS-Netzwerkschnittstellenindex der Schnittstelle direkt unterhalb des aktuellen Filtermoduls. Das heißt, wenn Filtermodule oder NDIS 5 vorhanden sind. x filter intermediate drivers that are installed over a physical miniport adapter or the highest-level MUX intermediate driver, this member contains the interface of the filter module interface or filter intermediate driver interface that is just below the current filter module module. Wenn keine Filtermodul- oder Filter-Zwischentreiberschnittstellen über den physischen Miniportadapter oder den MUX-Zwischentreiber der höchsten Ebene installiert sind, enthält dieses Element den Schnittstellenindex des zugrunde liegenden physischen Miniportadapters oder des virtuellen MINIPORTS des MUX-Zwischentreibers auf höchster Ebene.

LowerIfNetLuid

Die NDIS-Netzwerkschnittstelle NET_LUID Wert der Schnittstelle direkt unterhalb des aktuellen Filtermoduls. Das heißt, wenn Filtermodule oder NDIS 5 vorhanden sind. x filter intermediate drivers that are installed over a physical miniport adapter or the highest-level MUX intermediate driver, this member contains the network interface NET_LUID of the filter module interface or filter intermediate driver interface that is just below the current filter module. Wenn keine Filtermodul- oder Filterzwingtreiberschnittstellen über den physischen Miniportadapter oder den MUX-Zwischentreiber der obersten Ebene installiert sind, enthält dieses Element die Netzwerkschnittstelle NET_LUID des zugrunde liegenden physischen Miniportadapters oder des virtuellen MINIPORTS des mux-Zwischentreibers auf höchster Ebene.

Flags

Für die zukünftige Verwendung reserviert.

HDSplitCurrentConfig

Ein Zeiger auf eine NDIS_HD_SPLIT_CURRENT_CONFIG Struktur. Diese Struktur gibt die aktuelle Header-Daten-Split-Konfiguration des zugrunde liegenden Miniportadapters an. Dieser Wert kann NULL sein, wenn der Miniportadapter die Aufteilung von Headerdaten nicht unterstützt.

ReceiveFilterCapabilities

Ein Zeiger auf eine 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.

MiniportPhysicalDeviceObject

Ein Zeiger auf eine DEVICE_OBJECT-Struktur . Diese Struktur stellt das physische Gerät für den zugrunde liegenden Miniportadapter dar.

NicSwitchCapabilities

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

BaseMiniportIfConnectorPresent

Ein boolescher Wert, der bei Festlegung auf TRUE angibt, ob ein Netzwerkschnittstellenconnector (if) auf dem zugrunde liegenden Netzwerkadapter vorhanden ist. Dieser Wert sollte für einen physischen Adapter auf TRUE festgelegt werden.

SriovCapabilities

Ein Zeiger auf eine NDIS_SRIOV_CAPABILITIES-Struktur . Diese Struktur gibt die Sr-IOV-Funktionen (Single Root I/O Virtualization) an, die derzeit auf dem zugrunde liegenden Miniportadapter aktiviert sind. Dieser Wert kann NULL sein, wenn der Miniportadapter SR-IOV-Features nicht unterstützt.

Weitere Informationen finden Sie unter Single Root I/O Virtualization (SR-IOV).

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-Switch, der auf dem PF-Miniportadapter (Physical Function) erstellt wird. Daher kann dieses Array nur ein Element enthalten.

Hinweise

Zum Definieren von Filtermodulanfügungsparametern übergibt NDIS einen Zeiger auf eine NDIS_FILTER_ATTACH_PARAMETERS-Struktur an die FilterAttach-Funktion .

Filtertreiber sollten unnötige OID-Abfragen vermeiden. Verwenden Sie stattdessen die Informationen in NDIS_FILTER_ATTACH_PARAMETERS, sofern verfügbar, um Informationen zu zugrunde liegenden Treibern abzurufen.