NET_IF_INFORMATION Struktur (ndis.h)
Die NET_IF_INFORMATION Struktur stellt NDIS Informationen zu einer registrierten Netzwerkschnittstelle bereit.
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;
Angehörige
Header
Die NDIS_OBJECT_HEADER Struktur für die Schnittstelleninformationsstruktur (NET_IF_INFORMATION). Der Anbieter legt das Type Member der Struktur fest, das Header- angibt, NDIS_OBJECT_TYPE_DEFAULT, das Revisionselement auf NDIS_OBJECT_REVISION_1 und das Size Member 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 Null fest. Die folgenden Flagwerte werden definiert:
NIIF_HARDWARE_INTERFACE
Legen Sie fest, ob die Netzwerkschnittstelle für Hardware vorgesehen ist.
NIIF_FILTER_INTERFACE
Legen Sie fest, ob sich die Netzwerkschnittstelle für ein Filtermodul befindet.
NIIF_NDIS_RESERVED1
Reserviert für NDIS.
NIIF_NDIS_RESERVED2
Reserviert für NDIS.
NIIF_NDIS_RESERVED3
Reserviert für NDIS.
PhysicalLocation
Der physische Standort für die Hardware, die einer in einer Schnittstelle angegebenen Schnittstelle zugeordnet ist NET_PHYSICAL_LOCATION Struktur.
WanTunnelType
Der tunnelIfEncapsMethod (von RFC 2667) für WAN-Geräte. Wenn der WAN-Tunneltyp unbekannt ist, legen Sie dieses Element 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 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 PhysAddressOffset- und PermanentPhysAddressOffset- elemente angeben.
PhysAddressOffset
Der Offset der aktuellen physischen Adresse (in Byte) vom Anfang dieser Struktur. Die aktuelle physische Adresse ist ein Bytearray. Die Länge des Arrays wird im PhysAddressLength Member angegeben. Die aktuelle physische Adresse ist derselbe Wert, den die OID_802_3_CURRENT_ADDRESS OID zurückgibt.
PermanentPhysAddressOffset
Der Offset der dauerhaften physischen Adresse (in Byte) vom Anfang dieser Struktur. Die permanente physische Adresse ist ein Bytearray. Die Länge des Arrays wird im PhysAddressLength Member 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 in dieser Struktur beschrieben wird. Diese Länge ist die Länge des WCHAR-Arrays, das sich im Offset im FriendlyNameOffset Member befindet.
FriendlyNameOffset
Der Offset des Anfangs des Anzeigenamens in Byte vom Anfang dieser Struktur. Dieser Name sollte den Namen des Herstellers, des Produkts 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 über die Schnittstelle im beständigen Speicher speichert, sollte sie die GUID speichern und die GUID wiederverwenden, wenn sie die Schnittstelle nach dem Neustart des Computers erneut registriert.
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 Fachs.
SupportedStatistics
Die Statistiken, die die Schnittstelle unterstützt. 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 Mitteltyp für die Schnittstelle. Weitere Informationen finden Sie unter OID_GEN_PHYSICAL_MEDIUM
Bemerkungen
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 an 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 PhysAddressOffset, PermanentPhysAddressOffsetund FriendlyNameOffset Member angeben. Der Anbieter muss die Werte für die Arrays nach der Struktur bereitstellen und die Offsetmber festlegen, um die Position der Arrays zu identifizieren.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Unterstützt in NDIS 6.0 und höher. |
| Header- | ndis.h (include Ndis.h) |