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） 大小，以位元組為單位。類型
由因特網指派名稱授權單位 （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 和 VARIANT 位址 / 標頭格式，這些格式必須在系結建立系結之後，通訊協定驅動程式與基礎驅動程式之間進行交涉。
NdisMediumLocalTalk
4
LocalTalk 網路。
NdisMediumDix
5
驅動程式使用 DIX 乙太網路標頭格式的乙太網路。
NdisMediumArcnetRaw
6
ARCNET 網路。
NdisMediumArcnet878_2
7
ARCNET （878.2） 網路。
NdisMediumAtm
8
ATM 網路。 線上導向客戶端通訊協定驅動程式可以自行系結至傳回此值的基礎迷你埠驅動程式。 否則，舊版通訊協定驅動程式會自行系結至系統提供的 LanE 中繼驅動程式，此驅動程式會根據網路管理員設定 LanE 驅動程式的方式，將其中型類型報告為 NdisMedium802_3 或 NdisMedium802_5。
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 介面的迷你埠驅動程式，透過無線網路網路傳輸封包。
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 介面的迷你埠驅動程式，透過無線網路傳輸。
注意 NDIS 6.0 和更新版本支援 Native 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） |