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，以及必須在建立系結之後，通訊協定驅動程式與基礎驅動程式之間交涉的變體位址/標頭格式。
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. 支援無線區域網路 (WLAN) 或無線 WAN (WWAN) 封包的迷你埠驅動程式會將其媒體宣告為 NdisMedium802_3 ，並將乙太網路模擬至較高層級的 NDIS 驅動程式。
注意：此媒體類型不適用於 Windows Vista 或更新版本的 Windows。
NdisMediumIrda
10
irDA) 網路的基礎結構 (。
NdisMediumBpc
11
廣播電腦網路。
NdisMediumCoWan
12
連線導向環境中的廣域網路。
NdisMedium1394
13
IEEE 1394 (fire wire) 網路。
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) |