共用方式為

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

由因特網指派名稱授權單位所定義的介面類型， (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 軟體開發套件 (SDK) 上，頭檔的組織已變更，而且MIB_IFROW結構定義在 Ifmib.h 頭檔中，而不是在 Iprtrmib.h 頭檔中。 請注意， Ifmib.h 頭文件會自動包含在 Iprtrmib.h 中，該檔案會自動包含在 Iphlpapi.h 頭檔中。 Ifmib.h 和 Iprtrmib.h 頭文件不應該直接使用。

規格需求

需求 值
最低支援的用戶端 Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限傳統型應用程式]
標頭 ifmib.h (include Iphlpapi.h)

另請參閱

GetAdaptersAddresses

GetIfEntry

GetIfEntry2

IP_ADAPTER_ADDRESSES

MIB_IFSTATUS

MIB_IFTABLE

MIB_IF_TABLE2

MPR_INTERFACE_0