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)

另请参阅

GetIfEntry2

GetIfTable2

MIB_IF_TABLE2

NET_IF_ACCESS_TYPE

NET_IF_ADMIN_STATUS

NET_IF_CONNECTION_TYPE

NET_IF_DIRECTION_TYPE

NET_IF_MEDIA_CONNECT_STATE

NET_LUID

TUNNEL_TYPE