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 头文件中列出了接口类型的可能值。
下表列出了接口类型的常见值,尽管可能还有许多其他值。
dwMtu
类型:DWORD
最大传输单位 (MTU) 大小(以字节为单位)。
dwSpeed
类型:DWORD
接口的速度(以位/秒为单位)。
dwPhysAddrLen
类型:DWORD
bPhysAddr 成员指定的物理地址的长度(以字节为单位)。
bPhysAddr[MAXLEN_PHYSADDR]
类型: BYTE[MAXLEN_PHYSADDR]
此接口的适配器的物理地址。
dwAdminStatus
类型:DWORD
接口在管理上处于启用或禁用状态。
dwOperStatus
类型:DWORD
接口的操作状态。 此成员可以是 Ipifcons.h 头文件中定义的 INTERNAL_IF_OPER_STATUS 枚举中定义的以下值之一。
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) |