通过

ifmib.h) (MIB_IFROW 结构

  • 项目

MIB_IFROW结构存储有关特定接口的信息。

语法

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;

成员

wszName[MAX_INTERFACE_NAME_LEN]

类型： WCHAR[MAX_INTERFACE_NAME_LEN]

指向包含接口名称的 Unicode 字符串的指针。

dwIndex

类型：DWORD

标识接口的索引。 禁用然后启用网络适配器时，此索引值可能会更改，不应将其视为永久性。

dwType

类型：DWORD

Internet 分配名称机构 (IANA) 定义的接口类型。 有关详细信息，请参阅 http://www.iana.org/assignments/ianaiftype-mib。 Ipifcons.h 头文件中列出了接口类型的可能值。

下表列出了接口类型的常见值，尽管可能还有许多其他值。

值 含义
IF_TYPE_OTHER
1
 其他一些类型的网络接口。
IF_TYPE_ETHERNET_CSMACD
6
 以太网网络接口。
IF_TYPE_ISO88025_TOKENRING
9
 令牌环网络接口。
IF_TYPE_FDDI
15
 (FDDI) 网络接口的光纤分布式数据接口。
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) 高性能串行总线网络接口。
IF_TYPE_IEEE80216_WMAN
237
 适用于 WiMax 设备的移动宽带接口。
注意 Windows 7、Windows Server 2008 R2 及更高版本支持此接口类型。
 
IF_TYPE_WWANPP
243
 适用于基于 GSM 的设备的移动宽带接口。
注意 Windows 7、Windows Server 2008 R2 及更高版本支持此接口类型。
 
IF_TYPE_WWANPP2
244
 适用于基于 CDMA 的设备的移动宽带接口。
注意 Windows 7、Windows Server 2008 R2 及更高版本支持此接口类型。
 

dwMtu

类型：DWORD

最大传输单位 (MTU) 大小（以字节为单位）。

dwSpeed

类型：DWORD

接口的速度（以位/秒为单位）。

dwPhysAddrLen

类型：DWORD

bPhysAddr 成员指定的物理地址的长度（以字节为单位）。

bPhysAddr[MAXLEN_PHYSADDR]

类型： BYTE[MAXLEN_PHYSADDR]

此接口的适配器的物理地址。

dwAdminStatus

类型：DWORD

接口在管理上处于启用或禁用状态。

dwOperStatus

类型：DWORD

接口的操作状态。 此成员可以是 Ipifcons.h 头文件中定义的 INTERNAL_IF_OPER_STATUS 枚举中定义的以下值之一。

值 含义
IF_OPER_STATUS_NON_OPERATIONAL
 LAN 适配器已被禁用，例如，由于地址冲突。
IF_OPER_STATUS_UNREACHABLE
 未连接的 WAN 适配器。
IF_OPER_STATUS_DISCONNECTED
 对于 LAN 适配器：网络电缆断开连接。 对于 WAN 适配器：无运营商。
IF_OPER_STATUS_CONNECTING
 正在连接的 WAN 适配器。
IF_OPER_STATUS_CONNECTED
 连接到远程对等互连的 WAN 适配器。
IF_OPER_STATUS_OPERATIONAL
 LAN 适配器的默认状态

dwLastChange

类型：DWORD

时间长度，以百分之几秒 (10^-2 秒) ，从上次计算机重启开始，当接口进入其当前运行状态时开始。 此值在百分之 2^32 秒后滚动更新。

NDIS 当前不支持 dwLastChange 成员。 在 Windows Vista 及更高版本中，NDIS 对此成员返回零。 在早期版本的 Windows 上，此成员中为 NDIS 支持的接口返回任意值。 对于其他接口提供程序支持的接口，它们可能会返回适当的值。

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

类型：DWORD

bDescr 成员的长度（以字节为单位）。

bDescr[MAXLEN_IFDESCR]

类型： BYTE[MAXLEN_IFDESCR]

接口的说明。

注解

MIB_IFROW 结构的dwSpeed 成员对于 10 Gbit/s 网络适配器 (非常高速的网络接口不正确，例如，) ，因为 DWORD 中可以存储的最大值为 4,294,967,295。 应用程序应使用 GetIfEntry2 和 GetIfTable2 函数返回的 MIB_IF_ROW2 结构或 GetAdaptersAddresses 函数返回的 IP_ADAPTER_ADDRESSES 结构来确定高速网络接口的速度。

在为 Windows Vista 及更高版本发布的 Microsoft Windows 软件开发工具包 (Windows SDK) (SDK) 中，头文件的组织方式已更改，MIB_IFROW结构在 Ifmib.h 头文件中定义，而不是 Iprtrmib.h 头文件中。 请注意，Ifmib.h 头文件会自动包含在 Iphlpapi.h 头文件中的 Iprtrmib.h 中。 不应直接使用 Ifmib.h 和 Iprtrmib.h 头文件。

要求

要求 值
最低受支持的客户端 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
标头 ifmib.h (包括 Iphlpapi.h)

另请参阅

GetAdaptersAddresses

GetIfEntry

GetIfEntry2

IP_ADAPTER_ADDRESSES

MIB_IFSTATUS

MIB_IFTABLE

MIB_IF_TABLE2

MPR_INTERFACE_0