MIB_IF_ROW2 结构
MIB_IF_ROW2 结构存储有关特定接口的信息。
语法
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;
成员
InterfaceLuid
网络接口的本地唯一标识符 (LUID) 。InterfaceIndex
标识网络接口的索引。 禁用然后启用网络适配器时，此索引值可能会更改，不应将其视为永久性。InterfaceGuid
网络接口的 GUID。Alias
一个以 NULL 结尾的 Unicode 字符串，其中包含网络接口的别名。说明
一个以 NULL 结尾的 Unicode 字符串，其中包含网络接口的说明。PhysicalAddressLength
PhysicalAddress 成员指定的物理硬件地址的长度（以字节为单位）。PhysicalAddress
此网络接口的适配器的物理硬件地址。PermanentPhysicalAddress
此网络接口的适配器的永久物理硬件地址。Mtu
此网络接口的最大传输单元 (MTU) 大小（以字节为单位）。类型
Internet 分配名称机构定义的接口类型 (IANA) 。 有关详细信息，请参阅 IANAifType-MIB 定义。 Ipifcons.h 头文件中列出了接口类型的可能值。下表列出了接口类型的常见值，尽管许多其他值是可能的。
值 含义 IF_TYPE_OTHER
1
某些其他类型的网络接口
IF_TYPE_ETHERNET_CSMACD
6
以太网网络接口
IF_TYPE_ISO88025_TOKENRING
9
令牌环网络接口
IF_TYPE_PPP
23
PPP 网络接口
IF_TYPE_SOFTWARE_LOOPBACK
24
软件环回网络接口
IF_TYPE_ATM
37
ATM 网络接口
IF_TYPE_IEEE80211
71
IEEE 802.11 无线网络接口
IF_TYPE_TUNNEL
131
隧道类型封装网络接口
IF_TYPE_IEEE1394
144
IEEE 1394 (Firewire) 高性能串行总线网络接口
TunnelType
如果 Type 成员IF_TYPE_TUNNEL， 则TUNNEL_TYPE 类型，用于定义隧道使用的封装方法。MediaType
接口的 NDIS 媒体类型。 此成员可以是 Ntddndis.h 头文件中定义的 NDIS_MEDIUM 枚举类型的以下值之一。值 含义 NdisMedium802_3
0
以太网 (802.3) 网络。
NdisMedium802_5
1
令牌环 (802.5) 网络。
NdisMediumFddi
2
光纤分布式数据接口 (FDDI) 网络。
NdisMediumWan
3
广域网 (WAN) 。 此类型涵盖各种形式的点到点和 WAN NIC 以及变体地址/标头格式，在建立绑定后，必须在协议驱动程序和基础驱动程序之间协商这些格式。
NdisMediumLocalTalk
4
LocalTalk 网络。
NdisMediumDix
5
驱动程序使用 DIX 以太网标头格式的以太网网络。
NdisMediumArcnetRaw
6
ARCNET 网络。
NdisMediumArcnet878_2
7
ARCNET (878.2) 网络。
NdisMediumAtm
8
ATM 网络。 面向连接的客户端协议驱动程序可以将自身绑定到返回此值的基础微型端口驱动程序。 否则，旧协议驱动程序会自行绑定到系统提供的 LanE 中间驱动程序，后者将其中等类型报告为 NdisMedium802_3 或NdisMedium802_5，具体取决于网络管理员配置 LanE 驱动程序的方式。
NdisMediumWirelessWan
9
无线网络。 NDIS 5。 支持无线 LAN (WLAN) 或无线 WAN 的 x 微型端口驱动程序 (WWAN) 数据包将其媒体声明为 NdisMedium802_3 ，并将以太网模拟到更高级别的 NDIS 驱动程序。
注意 此媒体类型不适用于 Windows Vista 或更高版本的 Windows。
NdisMediumIrda
10
红外 (IrDA) 网络。
NdisMediumBpc
11
广播计算机网络。
NdisMediumCoWan
12
面向连接的环境中的广域网。
NdisMedium1394
13
IEEE 1394 (消防线) 网络。
NdisMediumInfiniBand
14
InfiniBand 网络。
NdisMediumTunnel
15
隧道网络。
NdisMediumNative802_11
16
本机 IEEE 802.11 网络。
NdisMediumLoopback
17
NDIS 环回网络。
PhysicalMediumType
NDIS 物理介质类型。 此成员可以是 Ntddndis.h 头文件中定义的 NDIS_PHYSICAL_MEDIUM 枚举类型的以下值之一。值 含义 NdisPhysicalMediumUnspecified
0
物理介质不是以下值。 例如，单向卫星馈送是未指定的物理介质。
NdisPhysicalMediumWirelessLan
1
数据包通过符合 802.11 接口的微型端口驱动程序通过无线 LAN 网络传输。
NdisPhysicalMediumCableModem
2
数据包通过基于 DOCSIS 的电缆网络传输。
NdisPhysicalMediumPhoneLine
3
数据包通过标准电话线路传输。 此类型包括 HomePNA 媒体。
NdisPhysicalMediumPowerLine
4
数据包通过连接到配电系统的线路传输。
NdisPhysicalMediumDSL
5
数据包通过数字订阅服务器线路 (DSL) 网络传输。 此类型包括 ADSL、UADSL (G.Lite) 和 SDSL。
NdisPhysicalMediumFibreChannel
6
数据包通过光纤通道互连传输。
NdisPhysicalMedium1394
7
数据包通过 IEEE 1394 总线传输。
NdisPhysicalMediumWirelessWan
8
数据包通过无线 WAN 链路传输。 此类型包括 CDPD、CDMA 和 GPRS。
NdisPhysicalMediumNative802_11
9
数据包通过符合本机 802.11 接口的微型端口驱动程序通过无线 LAN 网络传输。
注意 NDIS 6.0 及更高版本中支持本机 802.11 接口。
NdisPhysicalMediumBluetooth
10
数据包通过蓝牙网络传输。 蓝牙是一种短程无线技术，使用 2.4 GHz 频谱。
NdisPhysicalMediumInfiniband
11
数据包通过 InfiniBand 互连传输。
NdisPhysicalMediumUWB
13
数据包通过超宽带网络传输。
NdisPhysicalMedium802_3
14
数据包通过以太网 (802.3) 网络传输。
NdisPhysicalMedium802_5
15
数据包通过令牌环 (802.5) 网络传输。
NdisPhysicalMediumIrda
16
数据包通过红外 (IrDA) 网络传输。
NdisPhysicalMediumWiredWAN
17
数据包通过有线 WAN 网络传输。
NdisPhysicalMediumWiredCoWan
18
数据包在面向连接的环境中通过广域网传输。
NdisPhysicalMediumOther
19
数据包通过未由其他可能值描述的网络传输。
AccessType
NET_IF_ACCESS_TYPE NDIS 网络接口访问类型。DirectionType
NET_IF_DIRECTION_TYPE NDIS 网络接口方向类型。InterfaceAndOperStatusFlags
一组以下标志，用于提供有关接口的信息。 这些标志与按位 OR 运算组合使用。 如果未应用任何标志，则此成员设置为零。HardwareInterface
网络接口适用于硬件。FilterInterface
网络接口适用于筛选器模块。ConnectorPresent
网络接口上存在连接器。 如果有物理网络适配器，则会设置此值。NotAuthenticated
网络接口的默认端口未通过身份验证。 如果网络接口未由目标进行身份验证，则表示网络接口不处于操作模式。 尽管这种情况同时适用于有线和无线网络连接，但身份验证更常见于无线网络连接。NotMediaConnected
网络接口未处于媒体连接状态。 如果拔下有线网络的网络电缆，则会设置此值。 对于无线网络，此值是为未连接到网络的网络适配器设置的。已暂停
网络接口的网络堆栈处于暂停或暂停状态。 此值并不意味着计算机处于休眠状态。LowPower
网络接口处于低功耗状态。EndPointInterface
网络接口是终结点设备，而不是连接到网络的真正网络接口。 此值可由使用网络基础结构与计算机通信但不提供与外部网络连接的设备（例如智能手机）设置。 这些类型的设备必须设置此标志。
OperStatus
IF_OPER_STATUS NDIS 网络接口操作状态类型。AdminStatus
NET_IF_ADMIN_STATUS管理状态类型。MediaConnectState
NET_IF_MEDIA_CONNECT_STATE连接状态类型。NetworkGuid
与接口所属的网络关联的 GUID。ConnectionType
NET_IF_CONNECTION_TYPE NDIS 网络接口连接类型。TransmitLinkSpeed
传输链路的速度（以位/秒为单位）。ReceiveLinkSpeed
接收链接的速度（以位/秒为单位）。InOctets
通过此接口接收且未出错的数据的八位字节数。 此值包括单播、广播和多播数据包中的八位字节。InUcastPkts
通过此接口接收且未出错的单播数据包数。InNUcastPkts
通过此接口接收且未出错的非单播数据包数。 此值包括广播数据包和多播数据包。InDiscards
丢弃的传入数据包数，即使它们没有错误也是如此。InErrors
由于错误而丢弃的传入数据包数。InUnknownProtos
由于协议未知而丢弃的传入数据包数。InUcastOctets
通过此接口在单播数据包中未出错的情况下接收的数据的八位字节数。InMulticastOctets
通过此接口在多播数据包中未出错的情况下接收的数据的八位字节数。InBroadcastOctets
通过此接口接收的广播数据包中没有错误的数据的八位字节数。OutOctets
通过此接口传输且未出错的数据的八位字节数。 此值包括单播、广播和多播数据包中的八位字节。OutUcastPkts
通过此接口传输且未出错的单播数据包数。OutNUcastPkts
通过此接口传输且未出错的非单播数据包数。 此值包括广播数据包和多播数据包。OutDiscards
丢弃的传出数据包数，即使它们没有错误也是如此。OutErrors
由于错误而丢弃的传出数据包数。OutUcastOctets
通过此接口在单播数据包中传输且未出错的数据的八位字节数。OutMulticastOctets
通过此接口的多播数据包中未出错的情况下传输的数据的八位字节数。OutBroadcastOctets
通过此接口传输的广播数据包中没有错误的数据的八位字节数。OutQLen
传输队列长度。 当前未使用此字段。
注解
Type 字段的值在 Ipifcons.h 头文件中定义。 当前仅支持类型成员的说明中列出的可能值。
要求
版本 |
在 Windows Vista 和更高版本的 Windows 操作系统中可用。 |
标头 |
Netioapi.h (包括 Netioapi.h) |