You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
The locally unique identifier (LUID) for the network interface.
-field InterfaceIndex
Type: NET_IFINDEX
The index that identifies the network interface. This index value may change when a network adapter is disabled and then enabled, and should not be considered persistent.
-field InterfaceGuid
Type: GUID
The GUID for the network interface.
-field Alias
Type: WCHAR[IF_MAX_STRING_SIZE + 1]
A NULL-terminated Unicode string that contains the alias name of the network interface.
-field Description
Type: WCHAR[IF_MAX_STRING_SIZE + 1]
A NULL-terminated Unicode string that contains a description of the network interface.
-field PhysicalAddressLength
Type: ULONG
The length, in bytes, of the physical hardware address specified by the PhysicalAddress member.
-field PhysicalAddress
Type: UCHAR[IF_MAX_PHYS_ADDRESS_LENGTH]
The physical hardware address of the adapter for this network interface.
-field PermanentPhysicalAddress
Type: UCHAR[IF_MAX_PHYS_ADDRESS_LENGTH]
The permanent physical hardware address of the adapter for this network interface.
-field Mtu
Type: ULONG
The maximum transmission unit (MTU) size, in bytes, for this network interface.
The table below lists common values for the interface type although many other values are possible.
Value
Meaning
IF_TYPE_OTHER
1
Some other type of network interface.
IF_TYPE_ETHERNET_CSMACD
6
An Ethernet network interface.
IF_TYPE_ISO88025_TOKENRING
9
A token ring network interface.
IF_TYPE_FDDI
15
A Fiber Distributed Data Interface (FDDI) network interface.
IF_TYPE_PPP
23
A PPP network interface.
IF_TYPE_SOFTWARE_LOOPBACK
24
A software loopback network interface.
IF_TYPE_ATM
37
An ATM network interface.
IF_TYPE_IEEE80211
71
An IEEE 802.11 wireless network interface.
IF_TYPE_TUNNEL
131
A tunnel type encapsulation network interface.
IF_TYPE_IEEE1394
144
An IEEE 1394 (Firewire) high performance serial bus network interface.
IF_TYPE_IEEE80216_WMAN
237
A mobile broadband interface for WiMax devices.
Note This interface type is supported on Windows 7, Windows Server 2008 R2, and later.
IF_TYPE_WWANPP
243
A mobile broadband interface for GSM-based devices.
Note This interface type is supported on Windows 7, Windows Server 2008 R2, and later.
IF_TYPE_WWANPP2
244
A mobile broadband interface for CDMA-based devices.
Note This interface type is supported on Windows 7, Windows Server 2008 R2, and later.
-field TunnelType
Type: TUNNEL_TYPE
The encapsulation method used by a tunnel if the Type member is IF_TYPE_TUNNEL. The tunnel type is defined by the Internet Assigned Names Authority (IANA). For more information, see http://www.iana.org/assignments/ianaiftype-mib. This member can be one of the values from the TUNNEL_TYPE enumeration type defined in the Ifdef.h header file.
Value
Meaning
TUNNEL_TYPE_NONE
0
Not a tunnel.
TUNNEL_TYPE_OTHER
1
None of the following tunnel types.
TUNNEL_TYPE_DIRECT
2
A packet is encapsulated
directly within a normal IP header, with no
intermediate header, and unicast to the remote tunnel
endpoint.
TUNNEL_TYPE_6TO4
11
An IPv6 packet is encapsulated directly
within an IPv4 header, with no intermediate header,
and unicast to the destination determined by the 6to4 protocol.
TUNNEL_TYPE_ISATAP
13
An IPv6 packet is encapsulated directly
within an IPv4 header, with no intermediate header,
and unicast to the destination determined by the ISATAP protocol.
TUNNEL_TYPE_TEREDO
14
Teredo encapsulation.
-field MediaType
Type: NDIS_MEDIUM
The NDIS media type for the interface. This member can be one of the values from the NDIS_MEDIUM enumeration type defined in the Ntddndis.h header file.
Value
Meaning
NdisMedium802_3
0
An Ethernet (802.3) network.
NdisMedium802_5
1
A Token Ring (802.5) network.
NdisMediumFddi
2
A Fiber Distributed Data Interface (FDDI) network.
NdisMediumWan
3
A wide area network (WAN). This type covers various forms of point-to-point and WAN NICs, as well as variant address/header formats that must be negotiated between the protocol driver and the underlying driver after the binding is established.
NdisMediumLocalTalk
4
A LocalTalk network.
NdisMediumDix
5
An Ethernet network for which the drivers use the DIX Ethernet header format.
NdisMediumArcnetRaw
6
An ARCNET network.
NdisMediumArcnet878_2
7
An ARCNET (878.2) network.
NdisMediumAtm
8
An ATM network. Connection-oriented client protocol drivers can bind themselves to an underlying miniport driver that returns this value. Otherwise, legacy protocol drivers bind themselves to the system-supplied LanE intermediate driver, which reports its medium type as either NdisMedium802_3 or NdisMedium802_5, depending on how the LanE driver is configured by the network administrator.
NdisMediumWirelessWan
9
A wireless network. NDIS 5.X miniport drivers that support wireless LAN (WLAN) or wireless WAN (WWAN) packets do not use this NDIS media type, but declare their media type as NdisMedium802_3 and emulate Ethernet to higher-level NDIS drivers.
Note This media type is supported and can be used for Mobile Broadband only on Windows 7, Windows Server 2008 R2, and later.
NdisMediumIrda
10
An infrared (IrDA) network.
NdisMediumBpc
11
A broadcast PC network.
NdisMediumCoWan
12
A wide area network in a connection-oriented environment.
NdisMedium1394
13
An IEEE 1394 (fire wire) network.
NdisMediumInfiniBand
14
An InfiniBand network.
NdisMediumTunnel
15
A tunnel network.
Note This media type is supported on Windows Vista, Windows Server 2008, and later.
NdisMediumNative802_11
16
A native IEEE 802.11 network.
Note This media type is supported on Windows Vista, Windows Server 2008, and later.
NdisMediumLoopback
17
An NDIS loopback network.
Note This media type is supported on Windows Vista, Windows Server 2008, and later.
NdisMediumWiMax
18
An WiMax network.
Note This media type is supported on Windows 7, Windows Server 2008 R2, and later.
-field PhysicalMediumType
Type: NDIS_PHYSICAL_MEDIUM
The NDIS physical medium type. This member can be one of the values from the NDIS_PHYSICAL_MEDIUM enumeration type defined in the Ntddndis.h header file.
Value
Meaning
NdisPhysicalMediumUnspecified
0
The physical medium is none of the below values. For example, a one-way satellite feed is an unspecified physical medium.
NdisPhysicalMediumWirelessLan
1
Packets are transferred over a wireless LAN network through a miniport driver that conforms to the 802.11 interface.
NdisPhysicalMediumCableModem
2
Packets are transferred over a DOCSIS-based cable network.
NdisPhysicalMediumPhoneLine
3
Packets are transferred over standard phone lines. This includes HomePNA media, for example.
NdisPhysicalMediumPowerLine
4
Packets are transferred over wiring that is connected to a power distribution system.
NdisPhysicalMediumDSL
5
Packets are transferred over a Digital Subscriber Line (DSL) network. This includes ADSL, UADSL (G.Lite), and SDSL, for example.
NdisPhysicalMediumFibreChannel
6
Packets are transferred over a Fibre Channel interconnect.
NdisPhysicalMedium1394
7
Packets are transferred over an IEEE 1394 bus.
NdisPhysicalMediumWirelessWan
8
Packets are transferred over a Wireless WAN link. This includes mobile broadband devices that support CDPD, CDMA, GSM, and GPRS, for example.
NdisPhysicalMediumNative802_11
9
Packets are transferred over a wireless LAN network through a miniport driver that conforms to the Native 802.11 interface.
Note The Native 802.11 interface is supported in NDIS 6.0 and later versions.
NdisPhysicalMediumBluetooth
10
Packets are transferred over a Bluetooth network. Bluetooth is a short-range wireless technology that uses the 2.4 GHz spectrum.
NdisPhysicalMediumInfiniband
11
Packets are transferred over an Infiniband interconnect.
NdisPhysicalMediumWiMax
12
Packets are transferred over a WiMax network.
NdisPhysicalMediumUWB
13
Packets are transferred over an ultra wide band network.
NdisPhysicalMedium802_3
14
Packets are transferred over an Ethernet (802.3) network.
NdisPhysicalMedium802_5
15
Packets are transferred over a Token Ring (802.5) network.
NdisPhysicalMediumIrda
16
Packets are transferred over an infrared (IrDA) network.
NdisPhysicalMediumWiredWAN
17
Packets are transferred over a wired WAN network.
NdisPhysicalMediumWiredCoWan
18
Packets are transferred over a wide area network in a connection-oriented environment.
NdisPhysicalMediumOther
19
Packets are transferred over a network that is not described by other possible values.
-field AccessType
Type: NET_IF_ACCESS_TYPE
The interface access type. This member can be one of the values from the NET_IF_ACCESS_TYPE enumeration type defined in the Ifdef.h header file.
Value
Meaning
NET_IF_ACCESS_LOOPBACK
1
Loopback access type. This access type indicates that the interface loops back transmit data as receive data.
NET_IF_ACCESS_BROADCAST
2
The LAN access type which includes Ethernet. This access type indicates that the interface provides native support for multicast or broadcast services.
Note Mobile broadband interfaces with a MediaType of NdisMedium802_3 use this access type.
NET_IF_ACCESS_POINT_TO_POINT
3
Point-to-point access that supports CoNDIS/WAN, except for non-broadcast multi-access (NBMA) interfaces.
Note Mobile broadband interfaces with a MediaType of NdisMediumWirelessWan use this access type.
NET_IF_ACCESS_POINT_TO_MULTI_POINT
4
Point-to-multipoint access that supports non-broadcast multi-access (NBMA) media, including the "RAS Internal" interface, and native (non-LANE) ATM.
NET_IF_ACCESS_MAXIMUM
5
The maximum possible value for the NET_IF_ACCESS_TYPE enumeration type. This is not a legal value for AccessType member.
-field DirectionType
Type: NET_IF_DIRECTION_TYPE
The interface direction type. This member can be one of the values from the NET_IF_DIRECTION_TYPE enumeration type defined in the Ifdef.h header file.
Value
Meaning
NET_IF_DIRECTION_SENDRECEIVE
0
The send and receive direction type. This direction type indicates that the NDIS network interface can send and receive data.
NET_IF_DIRECTION_SENDONLY
1
The send only direction type. This direction type indicates that the NDIS network interface can only send data.
NET_IF_DIRECTION_RECEIVEONLY
2
The receive only direction type. This direction type indicates that the NDIS network interface can only receive data.
NET_IF_DIRECTION_MAXIMUM
3
The maximum possible value for the NET_IF_DIRECTION_TYPE enumeration type. This is not a legal value for DirectionType member.
-field InterfaceAndOperStatusFlags
A set of flags that provide information about the interface. These flags are combined with a bitwise OR operation. If none of the flags applies, then this member is set to zero.
Type: BOOLEAN
Set if the default port for the network interface is not authenticated. If a network interface is not authenticated by the target, then the network interface is not in an operational mode.
Although this applies to both wired and wireless network connections, authentication is more common for wireless network connections.
Type: BOOLEAN
Set if the network interface is not in a media-connected state. If a network cable is unplugged for a wired network, this would be set. For a wireless network, this is set for the network adapter that is not connected to a network.
-field InterfaceAndOperStatusFlags.Paused
Type: BOOLEAN
Set if the network stack for the network interface is in the paused or pausing state. This does not mean that the computer is in a hibernated state.
-field InterfaceAndOperStatusFlags.LowPower
Type: BOOLEAN
Set if the network interface is in a low power state.
Type: BOOLEAN
Set if the network interface is an endpoint device and not a true network interface that connects to a network. This can be set by devices such as smart phones which use networking infrastructure to communicate to the PC but do not provide connectivity to an external network. It is mandatory for these types of devices to set this flag.
-field OperStatus
Type: IF_OPER_STATUS
The operational status for the interface as defined in RFC 2863 as IfOperStatus. For more information, see http://www.ietf.org/rfc/rfc2863.txt. This member can be one of the values from the IF_OPER_STATUS enumeration type defined in the Ifdef.h header file.
Value
Meaning
IfOperStatusUp
1
The interface is up and able to pass packets.
IfOperStatusDown
2
The interface is down and not in a condition to pass packets. The IfOperStatusDown state has two meanings, depending on the
value of AdminStatus member.
If AdminStatus is not set to NET_IF_ADMIN_STATUS_DOWN and ifOperStatus is set to IfOperStatusDown then a
fault condition is presumed to exist on the interface.
If AdminStatus is set to IfOperStatusDown, then ifOperStatus will normally also
be set to IfOperStatusDown or IfOperStatusNotPresent and there is not necessarily a
fault condition on the interface.
IfOperStatusTesting
3
The interface is in testing mode.
IfOperStatusUnknown
4
The operational status of the interface is unknown.
IfOperStatusDormant
5
The interface is not
actually in a condition to pass packets (it is not up), but is
in a pending state, waiting for some external event. For on-demand interfaces, this new state identifies the situation where the
interface is waiting for events to place it in the IfOperStatusUp state.
IfOperStatusNotPresent
6
A refinement on the IfOperStatusDown state which
indicates that the relevant interface is down specifically because
some component (typically, a hardware device) is not present in
the managed system.
IfOperStatusLowerLayerDown
7
A refinement on the IfOperStatusDown state.
This new state indicates that this interface runs on top of one or
more other interfaces and that this interface is
down specifically because one or more of these lower-layer interfaces
are down.
-field AdminStatus
Type: NET_IF_ADMIN_STATUS
The administrative status for the interface as defined in RFC 2863. For more information, see http://www.ietf.org/rfc/rfc2863.txt. This member can be one of the values from the NET_IF_ADMIN_STATUS enumeration type defined in the Ifdef.h header file.
Value
Meaning
NET_IF_ADMIN_STATUS_UP
1
The interface is initialized and enabled. But the interface is not necessarily ready to transmit and receive network data because that depends on the operational status of the interface.
NET_IF_ADMIN_STATUS_DOWN
2
The interface is down, and this interface cannot be used to transmit or receive network data.
NET_IF_ADMIN_STATUS_TESTING
3
The interface is in a test mode, and no network data can be transmitted or received.
-field MediaConnectState
Type: NET_IF_MEDIA_CONNECT_STATE
The connection state of the interface. This member can be one of the values from the NET_IF_MEDIA_CONNECT_STATE enumeration type defined in the Ifdef.h header file.
Value
Meaning
MediaConnectStateUnknown
0
The connection state of the interface is unknown.
MediaConnectStateConnected
1
The interface is connected to the network.
MediaConnectStateDisconnected
2
The interface is not connected to the network.
-field NetworkGuid
Type: NET_IF_NETWORK_GUID
The GUID that is associated with the network that the interface belongs to.
-field ConnectionType
Type: NET_IF_CONNECTION_TYPE
The NDIS network interface connection type. This member can be one of the values from the NET_IF_CONNECTION_TYPE enumeration type defined in the Ifdef.h header file.
Value
Meaning
NET_IF_CONNECTION_DEDICATED
1
The connection type is dedicated. The connection comes up automatically when media sense is TRUE. For example, an Ethernet connection is dedicated.
NET_IF_CONNECTION_PASSIVE
2
The connection type is passive. The remote end must bring up the connection to the local station. For example, a RAS interface is passive.
NET_IF_CONNECTION_DEMAND
3
The connection type is demand-dial. A connection of this type comes up in response to a local action (sending a packet, for example).
NET_IF_CONNECTION_MAXIMUM
4
The maximum possible value for the NET_IF_CONNECTION_TYPE enumeration type. This is not a legal value for ConnectionType member.
-field TransmitLinkSpeed
Type: ULONG64
The speed in bits per second of the transmit link.
-field ReceiveLinkSpeed
Type: ULONG64
The speed in bits per second of the receive link.
-field InOctets
Type: ULONG64
The number of octets of data received without errors through this interface. This value includes octets in unicast, broadcast, and multicast packets.
-field InUcastPkts
Type: ULONG64
The number of unicast packets received without errors through this interface.
-field InNUcastPkts
Type: ULONG64
The number of non-unicast packets received without errors through this interface. This value includes broadcast and multicast packets.
-field InDiscards
Type: ULONG64
The number of inbound packets which were chosen to be discarded even though no errors were detected to prevent the packets from being deliverable to a higher-layer protocol.
-field InErrors
Type: ULONG64
The number of incoming packets that were discarded because of errors.
-field InUnknownProtos
Type: ULONG64
The number of incoming packets that were discarded because the protocol was unknown.
-field InUcastOctets
Type: ULONG64
The number of octets of data received without errors in unicast packets through this interface.
-field InMulticastOctets
Type: ULONG64
The number of octets of data received without errors in multicast packets through this interface.
-field InBroadcastOctets
Type: ULONG64
The number of octets of data received without errors in broadcast packets through this interface.
-field OutOctets
Type: ULONG64
The number of octets of data transmitted without errors through this interface. This value includes octets in unicast, broadcast, and multicast packets.
-field OutUcastPkts
Type: ULONG64
The number of unicast packets transmitted without errors through this interface.
-field OutNUcastPkts
Type: ULONG64
The number of non-unicast packets transmitted without errors through this interface. This value includes broadcast and multicast packets.
-field OutDiscards
Type: ULONG64
The number of outgoing packets that were discarded even though they did not have errors.
-field OutErrors
Type: ULONG64
The number of outgoing packets that were discarded because of errors.
-field OutUcastOctets
Type: ULONG64
The number of octets of data transmitted without errors in unicast packets through this interface.
-field OutMulticastOctets
Type: ULONG64
The number of octets of data transmitted without errors in multicast packets through this interface.
-field OutBroadcastOctets
Type: ULONG64
The number of octets of data transmitted without errors in broadcast packets through this interface.
-field OutQLen
Type: ULONG64
The transmit queue length. This field is not currently used.
-remarks
The MIB_IF_ROW2 structure is defined on Windows Vista and later.
The values for the Type field are defined in the Ipifcons.h header file. Only the possible values listed in the description of the Type member are currently supported.
Note that the Netioapi.h header file is automatically included in the Iphlpapi.h header file. The Netioapi.h header file should never be used directly.