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。别名
一个以 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（WWAN）数据包的 x 微型端口驱动程序将其介质声明为 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
数据包通过符合 Native 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） |