MIB_IF_ROW2-Struktur
Die MIB_IF_ROW2-Struktur speichert Informationen zu einer bestimmten Schnittstelle.
Syntax
typedef struct _MIB_IF_ROW2 {
NET_LUID InterfaceLuid;
NET_IFINDEX InterfaceIndex;
GUID InterfaceGuid;
WCHAR Alias[IF_MAX_STRING_SIZE + 1];
WCHAR Description[IF_MAX_STRING_SIZE + 1];
ULONG PhysicalAddressLength;
UCHAR PhysicalAddress[IF_MAX_PHYS_ADDRESS_LENGTH];
UCHAR PermanentPhysicalAddress[IF_MAX_PHYS_ADDRESS_LENGTH];
ULONG Mtu;
IFTYPE Type;
TUNNEL_TYPE TunnelType;
NDIS_MEDIUM MediaType;
NDIS_PHYSICAL_MEDIUM PhysicalMediumType;
NET_IF_ACCESS_TYPE AccessType;
NET_IF_DIRECTION_TYPE DirectionType;
struct {
BOOLEAN HardwareInterface :1;
BOOLEAN FilterInterface :1;
BOOLEAN ConnectorPresent :1;
BOOLEAN NotAuthenticated :1;
BOOLEAN NotMediaConnected :1;
BOOLEAN Paused :1;
BOOLEAN LowPower :1;
BOOLEAN EndPointInterface :1;
} InterfaceAndOperStatusFlags;
IF_OPER_STATUS OperStatus;
NET_IF_ADMIN_STATUS AdminStatus;
NET_IF_MEDIA_CONNECT_STATE MediaConnectState;
NET_IF_NETWORK_GUID NetworkGuid;
NET_IF_CONNECTION_TYPE ConnectionType;
ULONG64 TransmitLinkSpeed;
ULONG64 ReceiveLinkSpeed;
ULONG64 InOctets;
ULONG64 InUcastPkts;
ULONG64 InNUcastPkts;
ULONG64 InDiscards;
ULONG64 InErrors;
ULONG64 InUnknownProtos;
ULONG64 InUcastOctets;
ULONG64 InMulticastOctets;
ULONG64 InBroadcastOctets;
ULONG64 OutOctets;
ULONG64 OutUcastPkts;
ULONG64 OutNUcastPkts;
ULONG64 OutDiscards;
ULONG64 OutErrors;
ULONG64 OutUcastOctets;
ULONG64 OutMulticastOctets;
ULONG64 OutBroadcastOctets;
ULONG64 OutQLen;
} MIB_IF_ROW2, *PMIB_IF_ROW2;
Member
InterfaceLuid
Der lokal eindeutige Bezeichner (LUID) für die Netzwerkschnittstelle.InterfaceIndex
Der Index, der die Netzwerkschnittstelle identifiziert. Dieser Indexwert kann sich ändern, wenn ein Netzwerkadapter deaktiviert und dann aktiviert ist, und sollte nicht als persistent betrachtet werden.InterfaceGuid
Die GUID für die Netzwerkschnittstelle.Alias
Eine MIT NULL endende Unicode-Zeichenfolge, die den Aliasnamen der Netzwerkschnittstelle enthält.Beschreibung
Eine MIT NULL endende Unicode-Zeichenfolge, die eine Beschreibung der Netzwerkschnittstelle enthält.PhysicalAddressLength
Die Länge der physischen Hardwareadresse in Bytes, die vom PhysicalAddress-Member angegeben wird.PhysicalAddress
Die physische Hardwareadresse des Adapters für diese Netzwerkschnittstelle.PermanentPhysicalAddress
Die permanente physische Hardwareadresse des Adapters für diese Netzwerkschnittstelle.Mtu
Die maximale MTU-Größe (Transmission Unit) in Byte für diese Netzwerkschnittstelle.Type
Der Schnittstellentyp, der von der Internet Assigned Names Authority (IANA) definiert ist. Weitere Informationen finden Sie unter IANAifType-MIB-DEFINITIONEN. Mögliche Werte für den Schnittstellentyp sind in der Headerdatei Ipifcons.h aufgeführt.In der folgenden Tabelle sind allgemeine Werte für den Schnittstellentyp aufgeführt, obwohl viele andere Werte möglich sind.
Wert Bedeutung IF_TYPE_OTHER
1
Eine andere Art von Netzwerkschnittstelle
IF_TYPE_ETHERNET_CSMACD
6
Eine Ethernet-Netzwerkschnittstelle
IF_TYPE_ISO88025_TOKENRING
9
Eine Tokenring-Netzwerkschnittstelle
IF_TYPE_PPP
23
Eine PPP-Netzwerkschnittstelle
IF_TYPE_SOFTWARE_LOOPBACK
24
Eine Softwareschleifen-Netzwerkschnittstelle
IF_TYPE_ATM
37
Eine ATM-Netzwerkschnittstelle
IF_TYPE_IEEE80211
71
Eine IEEE 802.11-Funknetzwerkschnittstelle
IF_TYPE_TUNNEL
131
Eine Netzwerkschnittstelle vom Tunneltyp
IF_TYPE_IEEE1394
144
Eine HOCHLEISTUNGS-Serielle Bus-Netzwerkschnittstelle von IEEE 1394 (Firewire)
TunnelType
Wenn der Type-Member IF_TYPE_TUNNEL ist, ein TUNNEL_TYPE Typ, der die Kapselungsmethode definiert, die ein Tunnel verwendet.MediaType
Der NDIS-Medientyp für die Schnittstelle. Dieser Member kann einer der folgenden Werte aus dem NDIS_MEDIUM Enumerationstyp sein, der in der Headerdatei "Ntddndis.h" definiert ist.Wert Bedeutung NdisMedium802_3
0
Ein Ethernet-Netzwerk (802.3).
NdisMedium802_5
1
Ein Token ring -Netzwerk (802.5).
NdisMediumFddi
2
Ein FDDI-Netzwerk (Fiber Distributed Data Interface).
NdisMediumWan
3
Ein Wide Area Network (WAN). Dieser Typ deckt verschiedene Formen von Punkt-zu-Punkt- und WAN-NICs sowie variantenbasierte Adress-/Headerformate ab, die nach dem Herstellen der Bindung zwischen dem Protokolltreiber und dem zugrunde liegenden Treiber ausgehandelt werden müssen.
NdisMediumLocalTalk
4
Ein LocalTalk-Netzwerk.
NdisMediumDix
5
Ein Ethernet-Netzwerk, für das die Treiber das DIX-Ethernet-Headerformat verwenden.
NdisMediumArcnetRaw
6
Ein ARCNET-Netzwerk.
NdisMediumArcnet878_2
7
Ein ARCNET-Netzwerk (878.2).
NdisMediumAtm
8
Ein ATM-Netzwerk. Verbindungsorientierte Clientprotokolltreiber können sich an einen zugrunde liegenden Miniporttreiber binden, der diesen Wert zurückgibt. Andernfalls binden sich Legacyprotokolltreiber an den vom System bereitgestellten LanE-Zwischentreiber, der seinen mittleren Typ entweder als NdisMedium802_3 oder NdisMedium802_5 meldet, je nachdem, wie der Netzwerkadministrator den LanE-Treiber konfiguriert.
NdisMediumWirelessWan
9
Ein Drahtloses Netzwerk. NDIS 5. x Miniporttreiber, die WLAN- oder WWAN-Pakete (Wireless LAN) unterstützen, deklarieren ihr Medium als NdisMedium802_3 und emulieren Ethernet für NDIS-Treiber auf höherer Ebene.
Hinweis Dieser Medientyp ist nicht für die Verwendung unter Windows Vista oder höheren Versionen von Windows verfügbar.
NdisMediumIrda
10
Ein Infrarotnetzwerk (IrDA).
NdisMediumBpc
11
Ein Broadcastcomputernetzwerk.
NdisMediumCoWan
12
Ein Wide Area-Netzwerk in einer verbindungsorientierten Umgebung.
NdisMedium1394
13
Ein IEEE 1394-Netzwerk (Fire Wire).
NdisMediumInfiniBand
14
Ein InfiniBand-Netzwerk.
NdisMediumTunnel
15
Ein Tunnelnetzwerk.
NdisMediumNative802_11
16
Ein natives IEEE 802.11-Netzwerk.
NdisMediumLoopback
17
Ein NDIS-Loopbacknetzwerk.
PhysicalMediumType
Der physische Mediumtyp NDIS. Dieser Member kann einer der folgenden Werte aus dem NDIS_PHYSICAL_MEDIUM Enumerationstyp sein, der in der Headerdatei "Ntddndis.h" definiert ist.Wert Bedeutung NdisPhysicalMediumUnspecified
0
Das physische Medium ist keiner der folgenden Werte. Beispielsweise ist ein unidirektionales Satellitenfeed ein nicht spezifiziertes physisches Medium.
NdisPhysicalMediumWirelessLan
1
Pakete werden über ein WLAN-Netzwerk über einen Miniporttreiber übertragen, der der 802.11-Schnittstelle entspricht.
NdisPhysicalMediumCableModem
2
Pakete werden über ein DOCSIS-basiertes Kabelnetzwerk übertragen.
NdisPhysicalMediumPhoneLine
3
Pakete werden über Standardtelefonleitungen übertragen. Dieser Typ umfasst HomePNA-Medien.
NdisPhysicalMediumPowerLine
4
Pakete werden über eine Kabelverbindung übertragen, die mit einem Energieverteilungssystem verbunden ist.
NdisPhysicalMediumDSL
5
Pakete werden über ein DSL-Netzwerk (Digital Subscriber Line) übertragen. Dieser Typ umfasst ADSL, UADSL (G.Lite) und SDSL.
NdisPhysicalMediumFibreChannel
6
Pakete werden über eine Fibre Channel-Verbindung übertragen.
NdisPhysicalMedium1394
7
Pakete werden über einen IEEE 1394-Bus übertragen.
NdisPhysicalMediumWirelessWan
8
Pakete werden über eine Drahtlose WAN-Verbindung übertragen. Dieser Typ umfasst CDPD, CDMA und GPRS.
NdisPhysicalMediumNative802_11
9
Pakete werden über ein WLAN-Netzwerk über einen Miniporttreiber übertragen, der der Native 802.11-Schnittstelle entspricht.
Hinweis Die Native 802.11-Schnittstelle wird in NDIS 6.0 und höheren Versionen unterstützt.
NdisPhysicalMediumBluetooth
10
Pakete werden über ein Bluetooth-Netzwerk übertragen. Bluetooth ist eine Kurzstrecken-Funktechnologie, die das 2,4-GHz-Spektrum nutzt.
NdisPhysicalMediumInfiniband
11
Pakete werden über eine InfiniBand-Verbindung übertragen.
NdisPhysicalMediumUWB
13
Pakete werden über ein Ultra-Wide-Band-Netzwerk übertragen.
NdisPhysicalMedium802_3
14
Pakete werden über ein Ethernet-Netzwerk (802.3) übertragen.
NdisPhysicalMedium802_5
15
Pakete werden über ein Token Ring -Netzwerk (802.5) übertragen.
NdisPhysicalMediumIrda
16
Pakete werden über ein IrDA-Netzwerk (IrDA) übertragen.
NdisPhysicalMediumWiredWAN
17
Pakete werden über ein kabelgebundenes WAN-Netzwerk übertragen.
NdisPhysicalMediumWiredCoWan
18
Pakete werden über ein Wide Area-Netzwerk in einer verbindungsorientierten Umgebung übertragen.
NdisPhysicalMediumOther
19
Pakete werden über ein Netzwerk übertragen, das nicht durch andere mögliche Werte beschrieben wird.
AccessType
Ein NET_IF_ACCESS_TYPE NDIS-Netzwerkschnittstellenzugriffstyp.DirectionType
Ein NET_IF_DIRECTION_TYPE NDIS-Netzwerkschnittstellenrichtungstyp.InterfaceAndOperStatusFlags
Ein Satz der folgenden Flags, die Informationen zur Schnittstelle bereitstellen. Diese Flags werden mit einer bitweisen OR-Operation kombiniert. Wenn keines der Flags zutrifft, wird dieses Element auf 0 (null) festgelegt.HardwareInterface
Die Netzwerkschnittstelle ist für Hardware vorgesehen.FilterInterface
Die Netzwerkschnittstelle ist für ein Filtermodul vorgesehen.ConnectorPresent
Ein Connector ist auf der Netzwerkschnittstelle vorhanden. Dieser Wert wird festgelegt, wenn ein physischer Netzwerkadapter vorhanden ist.NotAuthenticated
Der Standardport für die Netzwerkschnittstelle ist nicht authentifiziert. Wenn eine Netzwerkschnittstelle nicht vom Ziel authentifiziert wird, befindet sich die Netzwerkschnittstelle nicht im Betriebsmodus. Obwohl diese Situation sowohl für kabelgebundene als auch für drahtlose Netzwerkverbindungen gilt, ist die Authentifizierung bei Drahtlosen Netzwerkverbindungen häufiger.NotMediaConnected
Die Netzwerkschnittstelle befindet sich nicht in einem mediengebundenen Zustand. Wenn ein Netzwerkkabel für ein kabelgebundenes Netzwerk nicht angeschlossen ist, wird dieser Wert festgelegt. Für ein Drahtlosnetzwerk wird dieser Wert für den Netzwerkadapter festgelegt, der nicht mit einem Netzwerk verbunden ist.Angehalten
Der Netzwerkstapel für die Netzwerkschnittstelle befindet sich im angehaltenen oder angehaltenen Zustand. Dieser Wert bedeutet nicht, dass sich der Computer in einem Ruhezustand befindet.LowPower
Die Netzwerkschnittstelle befindet sich in einem Energiesparzustand.EndPointInterface
Die Netzwerkschnittstelle ist ein Endpunktgerät und keine echte Netzwerkschnittstelle, die eine Verbindung mit einem Netzwerk herstellt. Dieser Wert kann von Geräten wie Smartphones festgelegt werden, die die Netzwerkinfrastruktur für die Kommunikation mit dem Computer verwenden, aber keine Verbindung mit einem externen Netzwerk bereitstellen. Diese Gerätetypen müssen dieses Flag festlegen.
OperStatus
Eine IF_OPER_STATUS NDIS-Netzwerkschnittstelle, die status betriebsbereit ist.AdminStatus
Der NET_IF_ADMIN_STATUS administrativen status typ.MediaConnectState
Der NET_IF_MEDIA_CONNECT_STATE Verbindungszustandstyp.NetworkGuid
Die GUID, die dem Netzwerk zugeordnet ist, zu dem die Schnittstelle gehört.ConnectionType
Ein NET_IF_CONNECTION_TYPE NDIS-Netzwerkschnittstellenverbindungstyp.TransmitLinkSpeed
Die Geschwindigkeit der Übertragungsverbindung in Bits pro Sekunde.ReceiveLinkSpeed
Die Geschwindigkeit des Empfangslinks in Bits pro Sekunde.InOctets
Die Anzahl der Oktette von Daten, die ohne Fehler über diese Schnittstelle empfangen werden. Dieser Wert umfasst Oktette in Unicast-, Broadcast- und Multicastpaketen.InUcastPkts
Die Anzahl der Unicastpakete, die ohne Fehler über diese Schnittstelle empfangen werden.InNUcastPkts
Die Anzahl der Nicht-Unicastpakete, die ohne Fehler über diese Schnittstelle empfangen werden. Dieser Wert umfasst Broadcast- und Multicastpakete.InDiscards
Die Anzahl der eingehenden Pakete, die verworfen wurden, obwohl keine Fehler aufgetreten sind.InErrors
Die Anzahl der eingehenden Pakete, die aufgrund von Fehlern verworfen wurden.InUnknownProtos
Die Anzahl der eingehenden Pakete, die verworfen wurden, weil das Protokoll unbekannt war.InUcastOctets
Die Anzahl der Oktette von Daten, die ohne Fehler in Unicastpaketen über diese Schnittstelle empfangen werden.InMulticastOctets
Die Anzahl der Oktette von Daten, die ohne Fehler in Multicastpaketen über diese Schnittstelle empfangen werden.InBroadcastOctets
Die Anzahl der Oktette von Daten, die ohne Fehler in Broadcastpaketen über diese Schnittstelle empfangen werden.OutOctets
Die Anzahl der Oktette von Daten, die ohne Fehler über diese Schnittstelle übertragen werden. Dieser Wert umfasst Oktette in Unicast-, Broadcast- und Multicastpaketen.OutUcastPkts
Die Anzahl der Unicastpakete, die ohne Fehler über diese Schnittstelle übertragen werden.OutNUcastPkts
Die Anzahl der Nicht-Unicastpakete, die ohne Fehler über diese Schnittstelle übertragen werden. Dieser Wert umfasst Broadcast- und Multicastpakete.OutDiscards
Die Anzahl der ausgehenden Pakete, die verworfen wurden, obwohl keine Fehler aufgetreten sind.OutErrors
Die Anzahl der ausgehenden Pakete, die aufgrund von Fehlern verworfen wurden.OutUcastOctets
Die Anzahl der Oktette von Daten, die ohne Fehler in Unicastpaketen über diese Schnittstelle übertragen werden.OutMulticastOctets
Die Anzahl der Oktette von Daten, die ohne Fehler in Multicastpaketen über diese Schnittstelle übertragen werden.OutBroadcastOctets
Die Anzahl der Oktette von Daten, die ohne Fehler in Broadcastpaketen über diese Schnittstelle übertragen werden.OutQLen
Die Länge der Übertragungswarteschlange. Dieses Feld wird derzeit nicht verwendet.
Bemerkungen
Die Werte für das Feld Typ werden in der Headerdatei Ipifcons.h definiert. Derzeit werden nur die möglichen Werte unterstützt, die in der Beschreibung des Typmembers aufgeführt sind.
Requirements (Anforderungen)
Version |
Verfügbar in Windows Vista und höheren Versionen der Windows-Betriebssysteme. |
Header |
Netioapi.h (netioapi.h einschließen) |