MIB_IFROW Struktur (ifmib.h)
Die MIB_IFROW-Struktur speichert Informationen zu einer bestimmten Schnittstelle.
Syntax
typedef struct _MIB_IFROW {
WCHAR wszName[MAX_INTERFACE_NAME_LEN];
IF_INDEX dwIndex;
IFTYPE dwType;
DWORD dwMtu;
DWORD dwSpeed;
DWORD dwPhysAddrLen;
UCHAR bPhysAddr[MAXLEN_PHYSADDR];
DWORD dwAdminStatus;
INTERNAL_IF_OPER_STATUS dwOperStatus;
DWORD dwLastChange;
DWORD dwInOctets;
DWORD dwInUcastPkts;
DWORD dwInNUcastPkts;
DWORD dwInDiscards;
DWORD dwInErrors;
DWORD dwInUnknownProtos;
DWORD dwOutOctets;
DWORD dwOutUcastPkts;
DWORD dwOutNUcastPkts;
DWORD dwOutDiscards;
DWORD dwOutErrors;
DWORD dwOutQLen;
DWORD dwDescrLen;
UCHAR bDescr[MAXLEN_IFDESCR];
} MIB_IFROW, *PMIB_IFROW;
Member
wszName[MAX_INTERFACE_NAME_LEN]
Typ: WCHAR[MAX_INTERFACE_NAME_LEN]
Ein Zeiger auf eine Unicode-Zeichenfolge, die den Namen der Schnittstelle enthält.
dwIndex
Art: DWORD
Der Index, der die Schnittstelle identifiziert. Dieser Indexwert kann sich ändern, wenn ein Netzwerkadapter deaktiviert und dann aktiviert ist, und sollte nicht als persistent betrachtet werden.
dwType
Art: DWORD
Der Von der Internet Assigned Names Authority (IANA) definierte Schnittstellentyp. Weitere Informationen finden Sie unter http://www.iana.org/assignments/ianaiftype-mib. 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.
dwMtu
Art: DWORD
Die maximale MTU-Größe (Maximum Transmission Unit) in Bytes.
dwSpeed
Art: DWORD
Die Geschwindigkeit der Schnittstelle in Bits pro Sekunde.
dwPhysAddrLen
Art: DWORD
Die Länge der vom bPhysAddr-Member angegebenen physischen Adresse in Bytes.
bPhysAddr[MAXLEN_PHYSADDR]
Typ: BYTE[MAXLEN_PHYSADDR]
Die physische Adresse des Adapters für diese Schnittstelle.
dwAdminStatus
Art: DWORD
Die Schnittstelle ist administrativ aktiviert oder deaktiviert.
dwOperStatus
Art: DWORD
Der operative status der Schnittstelle. Bei diesem Element kann es sich um einen der folgenden Werte handeln, die in der INTERNAL_IF_OPER_STATUS-Enumeration definiert sind, die in der Headerdatei Ipifcons.h definiert ist.
dwLastChange
Art: DWORD
Die Dauer in Hundertstel Sekunden (10^-2 Sekunden), beginnend mit dem letzten Neustart des Computers, wenn die Schnittstelle ihren aktuellen Betriebszustand erreicht hat. Dieser Wert wird nach 2^32 Hundertstel Sekunden überrollt.
Der dwLastChange-Member wird derzeit nicht von NDIS unterstützt. Unter Windows Vista und höher gibt NDIS null für dieses Element zurück. In früheren Versionen von Windows wird in diesem Member ein beliebiger Wert für die von NDIS unterstützten Schnittstellen zurückgegeben. Für Schnittstellen, die von anderen Schnittstellenanbietern unterstützt werden, können sie einen geeigneten Wert zurückgeben.
dwInOctets
Art: DWORD
Die Anzahl der Oktette von Daten, die über diese Schnittstelle empfangen werden.
dwInUcastPkts
Art: DWORD
Die Anzahl der Unicastpakete, die über diese Schnittstelle empfangen werden.
dwInNUcastPkts
Art: DWORD
Die Anzahl von Nicht-Unicast-Paketen, die über diese Schnittstelle empfangen werden. Broadcast- und Multicastpakete sind enthalten.
dwInDiscards
Art: DWORD
Die Anzahl der eingehenden Pakete, die verworfen wurden, obwohl sie keine Fehler hatten.
dwInErrors
Art: DWORD
Die Anzahl der eingehenden Pakete, die aufgrund von Fehlern verworfen wurden.
dwInUnknownProtos
Art: DWORD
Die Anzahl der eingehenden Pakete, die verworfen wurden, weil das Protokoll unbekannt war.
dwOutOctets
Art: DWORD
Die Anzahl der Oktette von Daten, die über diese Schnittstelle gesendet werden.
dwOutUcastPkts
Art: DWORD
Die Anzahl der Unicastpakete, die über diese Schnittstelle gesendet werden.
dwOutNUcastPkts
Art: DWORD
Die Anzahl von Nicht-Unicast-Paketen, die über diese Schnittstelle gesendet werden. Broadcast- und Multicastpakete sind enthalten.
dwOutDiscards
Art: DWORD
Die Anzahl der ausgehenden Pakete, die verworfen wurden, obwohl sie keine Fehler hatten.
dwOutErrors
Art: DWORD
Die Anzahl ausgehender Pakete, die aufgrund von Fehlern verworfen wurden.
dwOutQLen
Art: DWORD
Die Länge der Übertragungswarteschlange. Dieses Feld wird derzeit nicht verwendet.
dwDescrLen
Art: DWORD
Die Länge des bDescr-Elements in Bytes.
bDescr[MAXLEN_IFDESCR]
Typ: BYTE[MAXLEN_IFDESCR]
Eine Beschreibung der Schnittstelle.
Hinweise
Das dwSpeed-Element der MIB_IFROW-Struktur ist für Sehr-High-Speed-Netzwerkschnittstellen (z. B. 10 GBit/s-Netzwerkadapter) falsch, da der maximale Wert, der in einem DWORD gespeichert werden kann, 4.294.967.295 beträgt. Anwendungen sollten die von den Funktionen GetIfEntry2 und GetIfTable2 zurückgegebene MIB_IF_ROW2-Struktur oder die IP_ADAPTER_ADDRESSES Struktur verwenden, die von der GetAdaptersAddresses-Funktion zurückgegeben wird, um die Geschwindigkeit für Netzwerkschnittstellen mit sehr hoher Geschwindigkeit zu bestimmen.
Auf dem Microsoft Windows Software Development Kit (SDK), das für Windows Vista und höher veröffentlicht wurde, wurde die organization von Headerdateien geändert, und die MIB_IFROW Struktur ist in der Headerdatei Ifmib.h nicht in der Headerdatei Iprtrmib.h definiert. Beachten Sie, dass die Headerdatei Ifmib.h automatisch in Iprtrmib.h enthalten ist, die automatisch in der Headerdatei Iphlpapi.h enthalten ist. Die Headerdateien Ifmib.h und Iprtrmib.h sollten nie direkt verwendet werden.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
| Kopfzeile | ifmib.h (include Iphlpapi.h) |