NET_IF_INFORMATION-Struktur (ndis.h)

Artikel
02/26/2024

Die NET_IF_INFORMATION-Struktur stellt NDIS Informationen zu einer registrierten Netzwerkschnittstelle zur Verfügung.

Syntax

typedef struct _NET_IF_INFORMATION {
  NDIS_OBJECT_HEADER     Header;
  ULONG                  Flags;
  NET_PHYSICAL_LOCATION  PhysicalLocation;
  ULONG                  WanTunnelType;
  ULONG                  PortNumber;
  NET_IF_ACCESS_TYPE     AccessType;
  NET_IF_DIRECTION_TYPE  DirectionType;
  NET_IF_CONNECTION_TYPE ConnectionType;
  BOOLEAN                ifConnectorPresent;
  USHORT                 PhysAddressLength;
  USHORT                 PhysAddressOffset;
  USHORT                 PermanentPhysAddressOffset;
  USHORT                 FriendlyNameLength;
  USHORT                 FriendlyNameOffset;
  GUID                   InterfaceGuid;
  NET_IF_NETWORK_GUID    NetworkGuid;
  ULONG                  SupportedStatistics;
  NDIS_MEDIUM            MediaType;
  NDIS_PHYSICAL_MEDIUM   PhysicalMediumType;
} NET_IF_INFORMATION, *PNET_IF_INFORMATION;

Member

Header

Die NDIS_OBJECT_HEADER-Struktur für die Schnittstelleninformationsstruktur (NET_IF_INFORMATION). Der Anbieter legt das Type-Element der Struktur, die Header angibt, auf NDIS_OBJECT_TYPE_DEFAULT fest, der Revisionsmember auf NDIS_OBJECT_REVISION_1 und das Size-Element auf NDIS_SIZEOF_NET_IF_INFORMATION_REVISION_1.

Flags

Flags, die Informationen über die Schnittstelle bereitstellen, die diese Struktur beschreibt. Diese Flags werden mit einem bitweisen OR-Vorgang kombiniert. Wenn keines der Flags zutrifft, legen Sie dieses Element auf 0 fest. Die folgenden Flagwerte werden definiert:

NIIF_HARDWARE_INTERFACE

Legen Sie fest, ob die Netzwerkschnittstelle für Hardware verwendet wird.

NIIF_FILTER_INTERFACE

Legen Sie fest, ob die Netzwerkschnittstelle für ein Filtermodul verwendet wird.

NIIF_NDIS_RESERVED1

Reserviert für NDIS.

NIIF_NDIS_RESERVED2

Reserviert für NDIS.

NIIF_NDIS_RESERVED3

Reserviert für NDIS.

PhysicalLocation

Der physische Speicherort für die Hardware, die einer in einer angegebenen Schnittstelle zugeordnet ist NET_PHYSICAL_LOCATION Struktur.

WanTunnelType

TunnelIfEncapsMethod (aus RFC 2667) für WAN-Geräte. Wenn der WAN-Tunneltyp unbekannt ist, legen Sie diesen Member auf NIIF_WAN_TUNNEL_TYPE_UNKNOWN fest.

PortNumber

Die NDIS-Portnummer für die Schnittstelle.

AccessType

Ein NET_IF_ACCESS_TYPE NDIS-Netzwerkschnittstellenzugriffstyp.

DirectionType

Ein NET_IF_DIRECTION_TYPE NDIS-Netzwerkschnittstellenrichtungstyp.

ConnectionType

Ein NET_IF_CONNECTION_TYPE NDIS-Netzwerkschnittstellenverbindungstyp.

ifConnectorPresent

Ein boolescher Wert, der angibt, ob ein Connector vorhanden ist. Legen Sie diesen Wert auf TRUE fest, wenn ein physischer Adapter vorhanden ist, oder auf FALSE , wenn kein physischer Adapter vorhanden ist.

PhysAddressLength

Die Länge der physischen Adresse oder MAC-Adresse in Bytes. Diese Länge ist die Länge der Bytearrays, die sich an den Offsets befinden, die die Member PhysAddressOffset und PermanentPhysAddressOffset angeben.

PhysAddressOffset

Der Offset der aktuellen physischen Adresse in Bytes vom Anfang dieser Struktur. Die aktuelle physische Adresse ist ein Array von Bytes. Die Länge des Arrays wird im PhysAddressLength-Element angegeben. Die aktuelle physische Adresse ist derselbe Wert, den die OID_802_3_CURRENT_ADDRESS OID zurückgibt.

PermanentPhysAddressOffset

Der Offset der permanenten physischen Adresse in Bytes vom Anfang dieser Struktur. Die permanente physische Adresse ist ein Array von Bytes. Die Länge des Arrays wird im PhysAddressLength-Element angegeben. Die permanente physische Adresse ist derselbe Wert, den die OID_802_3_PERMANENT_ADDRESS OID zurückgibt.

FriendlyNameLength

Die Länge des Anzeigenamens für die Schnittstelle, die diese Struktur beschreibt. Diese Länge ist die Länge des WCHAR-Arrays, das sich im Offset im FriendlyNameOffset-Element befindet.

FriendlyNameOffset

Der Offset des Anfangs des Anzeigenamens in Bytes vom Anfang dieser Struktur. Dieser Name sollte den Namen des Herstellers, das Produkt und die Version der Schnittstellenhardware und -software enthalten. Der Name wird als Array von WCHAR-Werten angegeben. Das FriendlyNameLength-Element gibt die Länge des Arrays an.

InterfaceGuid

Die GUID, die der Schnittstelle zugeordnet ist. Der Schnittstellenanbieter generiert die Schnittstellen-GUID für die Schnittstelle. Der Anbieter kann die ExUuidCreate-Routine aufrufen, um die GUID zu erstellen. Die Schnittstellen-GUID sollte dem NET_LUID Wert zugeordnet werden, der der Schnittstelle zugewiesen ist. Wenn der Anbieter Informationen zur Schnittstelle im persistenten Speicher beibehält, sollte er die GUID speichern und die GUID wiederverwenden, wenn die Schnittstelle nach dem Neustart des Computers erneut registriert wird.

NetworkGuid

Die GUID, die dem Netzwerk zugeordnet ist, zu dem die Schnittstelle gehört. Wenn der Schnittstellenanbieter die Netzwerk-GUID nicht bereitstellen kann, kann er eine NULL-GUID übergeben. In diesem Fall registriert NDIS die Schnittstelle im Standardnetzwerk des primären Abteils.

SupportedStatistics

Die von der Schnittstelle unterstützten Statistiken. Weitere Informationen finden Sie im SupportedStatistics-Member des NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES Struktur .

MediaType

Der NdisMediumXxx-Typ , den die Schnittstelle unterstützt. Weitere Informationen finden Sie unter NDIS_MEDIUM.

PhysicalMediumType

Der physische Mediumtyp für die Schnittstelle. Weitere Informationen finden Sie unter OID_GEN_PHYSICAL_MEDIUM

Hinweise

Ein Netzwerkschnittstellenanbieter initialisiert eine NET_IF_INFORMATION-Struktur, um NDIS Informationen zu einer registrierten Schnittstelle bereitzustellen. Um eine Schnittstelle zu registrieren, übergibt ein Anbieter einen Zeiger auf eine NET_IF_INFORMATION-Struktur an die NdisIfRegisterInterface-Funktion .

Der Schnittstellenanbieter sollte genügend Arbeitsspeicher für die Struktur und die Arrays zuweisen, die die Mitglieder PhysAddressOffset, PermanentPhysAddressOffset und FriendlyNameOffset angeben. Der Anbieter muss die Werte für die Arrays nach der Struktur bereitstellen und die Offsetmember festlegen, um den Speicherort der Arrays zu identifizieren.