NDIS_INTERFACE_INFORMATION-Struktur (ifdef.h)
Die NDIS_INTERFACE_INFORMATION-Struktur stellt Informationen zu einer Netzwerkschnittstelle für die OID_GEN_INTERFACE_INFO OID bereit.
Syntax
typedef struct _NDIS_INTERFACE_INFORMATION {
NET_IF_OPER_STATUS ifOperStatus;
ULONG ifOperStatusFlags;
NET_IF_MEDIA_CONNECT_STATE MediaConnectState;
NET_IF_MEDIA_DUPLEX_STATE MediaDuplexState;
ULONG ifMtu;
BOOLEAN ifPromiscuousMode;
BOOLEAN ifDeviceWakeUpEnable;
ULONG64 XmitLinkSpeed;
ULONG64 RcvLinkSpeed;
ULONG64 ifLastChange;
ULONG64 ifCounterDiscontinuityTime;
ULONG64 ifInUnknownProtos;
ULONG64 ifInDiscards;
ULONG64 ifInErrors;
ULONG64 ifHCInOctets;
ULONG64 ifHCInUcastPkts;
ULONG64 ifHCInMulticastPkts;
ULONG64 ifHCInBroadcastPkts;
ULONG64 ifHCOutOctets;
ULONG64 ifHCOutUcastPkts;
ULONG64 ifHCOutMulticastPkts;
ULONG64 ifHCOutBroadcastPkts;
ULONG64 ifOutErrors;
ULONG64 ifOutDiscards;
ULONG64 ifHCInUcastOctets;
ULONG64 ifHCInMulticastOctets;
ULONG64 ifHCInBroadcastOctets;
ULONG64 ifHCOutUcastOctets;
ULONG64 ifHCOutMulticastOctets;
ULONG64 ifHCOutBroadcastOctets;
NET_IF_COMPARTMENT_ID CompartmentId;
ULONG SupportedStatistics;
} NDIS_INTERFACE_INFORMATION, *PNDIS_INTERFACE_INFORMATION;
Member
ifOperStatus
Die operative status der Schnittstelle. Dieser status entspricht dem Wert, den die OID_GEN_OPERATIONAL_STATUS OID zurückgibt.
ifOperStatusFlags
Die betriebsbereiten status Flags der Schnittstelle. Dieses Feld ist für den NDIS-Proxyschnittstellenanbieter reserviert. Andere Schnittstellenanbieter sollten diesen Member auf 0 (null) festlegen.
MediaConnectState
Der NET_IF_MEDIA_CONNECT_STATE Verbindungszustandstyp.
MediaDuplexState
Der Medienduplexstatus der Schnittstelle. Dieser Zustand entspricht dem Wert, den die OID_GEN_MEDIA_DUPLEX_STATE OID zurückgibt.
ifMtu
Die maximale Transmission Unit (MTU) der Schnittstelle. Diese MTU entspricht dem Wert, den die OID_GEN_MAXIMUM_FRAME_SIZE OID zurückgibt.
ifPromiscuousMode
Ein boolescher Wert, der TRUE ist, wenn sich die Schnittstelle im promiskellen Modus befindet, oder FALSE , wenn dies nicht der Fall ist. Dieser Wert entspricht dem Wert, den OID_GEN_PROMISCUOUS_MODE OID-Abfrage zurückgibt.
ifDeviceWakeUpEnable
Ein boolescher Wert, der TRUE ist, wenn die Schnittstelle wake-on-LAN-Funktionen unterstützt und die Funktion aktiviert ist, oder FALSE , wenn dies nicht der Fall ist.
XmitLinkSpeed
Die Übertragungslinkgeschwindigkeit der Schnittstelle in Bytes pro Sekunde. Diese Geschwindigkeit entspricht dem Wert, den eine OID_GEN_XMIT_LINK_SPEED OID-Abfrage zurückgibt.
RcvLinkSpeed
Die Empfangslinkgeschwindigkeit der Schnittstelle in Bytes pro Sekunde. Diese Geschwindigkeit entspricht dem Wert, den eine OID_GEN_RCV_LINK_SPEED OID-Abfrage zurückgibt.
ifLastChange
Die Zeit, zu der die Schnittstelle in ihren aktuellen Betriebszustand gelangt ist. Dieses Mal entspricht dem Wert, den eine OID_GEN_LAST_CHANGE OID-Abfrage zurückgibt.
ifCounterDiscontinuityTime
Der Zeitpunkt der letzten Diskontinuität der Leistungsindikatoren der Schnittstelle. Dieses Mal entspricht dem Wert, den eine OID_GEN_DISCONTINUITY_TIME OID-Abfrage zurückgibt.
ifInUnknownProtos
Die Anzahl der Pakete, die über die Schnittstelle empfangen und aufgrund eines unbekannten oder nicht unterstützten Protokolls verworfen wurden. Diese Zahl entspricht dem Wert, den eine OID_GEN_UNKNOWN_PROTOS OID-Abfrage zurückgibt.
ifInDiscards
Die Anzahl der eingehenden Pakete, die verworfen wurden, obwohl keine Fehler erkannt wurden, um zu verhindern, dass sie an ein Protokoll mit höherer Ebene übermittelt werden können. Diese Zahl entspricht dem Wert, den eine OID_GEN_RCV_DISCARDS OID-Abfrage zurückgibt.
ifInErrors
Die Anzahl der eingehenden Pakete, die Fehler enthielten, die verhinderten, dass sie an ein Protokoll mit höherer Ebene übermittelt werden können. Diese Zahl entspricht dem Wert, den eine OID_GEN_RCV_ERROR OID-Abfrage zurückgibt.
ifHCInOctets
Die Gesamtanzahl der Bytes, die auf dieser Schnittstelle empfangen werden. Diese Zahl entspricht dem Wert, den eine OID_GEN_BYTES_RCV OID zurückgibt.
ifHCInUcastPkts
Die Anzahl der weitergeleiteten Pakete, die ohne Fehler auf der Schnittstelle empfangen werden. Diese Zahl entspricht dem Wert, den eine OID_GEN_DIRECTED_FRAMES_RCV OID-Abfrage zurückgibt.
ifHCInMulticastPkts
Die Anzahl der Multicast-/Funktionspakete, die ohne Fehler auf der Schnittstelle empfangen werden. Diese Zahl entspricht dem Wert, den eine OID_GEN_MULTICAST_FRAMES_RCV OID-Abfrage zurückgibt.
ifHCInBroadcastPkts
Die Anzahl der Broadcastpakete, die ohne Fehler auf der Schnittstelle empfangen werden. Diese Zahl entspricht dem Wert, den eine OID_GEN_BROADCAST_FRAMES_RCV OID-Abfrage zurückgibt.
ifHCOutOctets
Die Anzahl der Bytes, die ohne Fehler auf der Schnittstelle übertragen werden. Diese Zahl entspricht dem Wert, den eine OID_GEN_BYTES_XMIT OID-Abfrage zurückgibt.
ifHCOutUcastPkts
Die Anzahl der gerichteten Pakete, die ohne Fehler auf der Schnittstelle übertragen werden. Diese Zahl entspricht dem Wert, den eine OID_GEN_DIRECTED_FRAMES_XMIT OID-Abfrage zurückgibt.
ifHCOutMulticastPkts
Die Anzahl der Multicast-/Funktionspakete, die ohne Fehler auf der Schnittstelle übertragen werden. Diese Zahl entspricht dem Wert, den eine OID_GEN_MULTICAST_FRAMES_XMIT OID-Abfrage zurückgibt.
ifHCOutBroadcastPkts
Die Anzahl der Broadcastpakete, die ohne Fehler auf der Schnittstelle übertragen werden. Diese Zahl entspricht dem Wert, den eine OID_GEN_BROADCAST_FRAMES_XMIT OID-Abfrage zurückgibt.
ifOutErrors
Die Anzahl der Pakete, die die Schnittstelle nicht übertragen kann. Diese Zahl entspricht dem Wert, den eine OID_GEN_XMIT_ERROR OID-Abfrage zurückgibt.
ifOutDiscards
Die Anzahl der Pakete, die die Schnittstelle verwirft. Diese Zahl entspricht dem Wert, den eine OID_GEN_XMIT_DISCARDS OID-Abfrage zurückgibt.
ifHCInUcastOctets
Die Anzahl der Bytes in weitergeleiteten Paketen, die ohne Fehler empfangen werden. Diese Anzahl ist derselbe Wert, den OID_GEN_DIRECTED_BYTES_RCV zurückgibt.
ifHCInMulticastOctets
Die Anzahl der Bytes in Multicast-/Funktionspaketen, die ohne Fehler empfangen werden. Diese Anzahl ist derselbe Wert, den OID_GEN_MULTICAST_BYTES_RCV zurückgibt.
ifHCInBroadcastOctets
Die Anzahl der Bytes in Broadcastpaketen, die ohne Fehler empfangen werden. Diese Anzahl ist derselbe Wert, den OID_GEN_BROADCAST_BYTES_RCV zurückgibt.
ifHCOutUcastOctets
Die Anzahl der Bytes in gerichteten Paketen, die ohne Fehler übertragen werden. Diese Anzahl ist der gleiche Wert, den OID_GEN_DIRECTED_BYTES_XMIT zurückgibt.
ifHCOutMulticastOctets
Die Anzahl der Bytes in Multicast-/Funktionspaketen, die ohne Fehler übertragen werden. Diese Anzahl ist derselbe Wert, den OID_GEN_MULTICAST_BYTES_XMIT zurückgibt.
ifHCOutBroadcastOctets
Die Anzahl der Bytes in Broadcastpaketen, die ohne Fehler übertragen werden. Diese Anzahl ist der gleiche Wert, den OID_GEN_BROADCAST_BYTES_XMIT zurückgibt.
CompartmentId
Das Fach, zu dem die Schnittstelle gehört, wenn der Schnittstellenanbieter die ID des Fachs angeben kann, zu dem die Schnittstelle gehört. Andernfalls sollte NET_IF_COMPARTMENT_ID_UNSPECIFIED zurückgegeben werden. Wenn der Schnittstellenanbieter NET_IF_COMPARTMENT_ID_UNSPECIFIED für die Fach-ID zurückgibt, gibt NDIS die richtige Fach-ID für diese Schnittstelle zurück.
SupportedStatistics
Die unterstützten Statistiken. Weitere Informationen finden Sie im SupportedStatistics-Member der NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES-Struktur .
Hinweise
NDIS-Schnittstellenanbieter füllen eine NDIS_INTERFACE_INFORMATION-Struktur als Reaktion auf eine Abfrage der OID_GEN_INTERFACE_INFO OID auf. Diese Struktur enthält Informationen, die sich während der Lebensdauer der Schnittstelle ändern.
Um sich als Schnittstellenanbieter zu registrieren, ruft ein NDIS-Treiber die NdisIfRegisterProvider-Funktion auf.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Unterstützt für NDIS 6.0-Treiber in Windows Vista. |
| Kopfzeile | ifdef.h (include Ndis.h) |
Weitere Informationen
NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES