2.2.1.2.108 IPX_INTERFACE

The IPX_INTERFACE structure MAY<99> be used to describe the MIB Row for IPX_INTERFACE_TABLE. This structure is returned as part of the following methods:

• RMIBEntryGet (section 3.1.4.30)

• RMIBEntryGetFirst (section 3.1.4.31)

• RMIBEntryGetNext (section 3.1.4.32)

   typedef struct _IPX_INTERFACE {
     ULONG InterfaceIndex;
     ULONG AdministratorState;
     ULONG AdapterIndex;
     UCHAR InterfaceName[48];
     ULONG InterfaceType;
     ULONG MediaType;
     UCHAR NetNumber[4];
     UCHAR MacAddress[6];
     ULONG Delay;
     ULONG Throughput;
     ULONG NetbiosAccept;
     ULONG NetbiosDeliver;
     ULONG EnableIpxWanNegotiation;
     IPX_IF_STATS IfStats;
   } IPX_INTERFACE,
    *PIPX_INTERFACE;
  

InterfaceIndex: The local index value for the network interface. This index value MAY change when a network adapter is disabled and then enabled, or under other circumstances, and need not be persistent.

AdministratorState: This MUST be set to the desired state of the interface. A value of 0x00000001 disables the interface and a value of 0x00000002 enables the interface.

AdapterIndex: The interface index associated with the network adapter.

InterfaceName: A null-terminated Unicode string that contains the name of the adapter.

InterfaceType: The type of the interface. The type MUST be one of the following values.

Value	Meaning
IF_TYPE_OTHER 0x00000001	Other
IF_TYPE_LAN 0x00000002	LAN
IF_TYPE_WAN_ROUTER 0x00000003	WAN router
IF_TYPE_WAN_WORKSTATION 0x00000004	Remote workstation dialing in
IF_TYPE_INTERNAL 0x00000005	Internal (virtual) interface
IF_TYPE_PERSONAL_WAN_ROUTER 0x00000006	Personal WAN router
IF_TYPE_ROUTER_WORKSTATION_DIALOUT 0x00000007	Local workstation dialing out
IF_TYPE_STANDALONE_WORKSTATION_DIALOUT 0x00000008	Stand-alone workstation dialing out

MediaType: The type of media. This MUST one of the following values.

Value	Meaning
NdisMedium802_3 0x00000000	An Ethernet (802.3) network.
NdisMedium802_5 0x00000001	A Token Ring (802.5) network.
NdisMediumFddi 0x00000002	A Fiber Distributed Data Interface (FDDI) network.
NdisMediumWan 0x00000003	A wide area network (WAN). This type covers various forms of point-to-point and WAN NICs and variant address/header formats that MUST be negotiated between the protocol driver and the underlying driver after the binding is established.
NdisMediumLocalTalk 0x00000004	A LocalTalk network.
NdisMediumDix 0x00000005	An Ethernet network for which the drivers use the DIX Ethernet header format.
NdisMediumArcnetRaw 0x00000006	An ARCNET network.
NdisMediumArcnet878_2 0x00000007	An ARCNET (878.2) network.
NdisMediumAtm 0x00000008	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 network administrator configures the LanE driver.
NdisMediumWirelessWan 0x00000009	A wireless network. NDIS 5.x miniport drivers that support wireless LAN (WLAN) or wireless WAN (WWAN) packets declare their medium as NdisMedium802_3 and emulate Ethernet to higher-level NDIS drivers.<100>
NdisMediumIrda 0x0000000A	An infrared (IrDA) network.
NdisMediumBpc 0x0000000B	A broadcast computer network.
NdisMediumCoWan 0x0000000C	A wide area network (WAN) in a connection-oriented environment.
NdisMedium1394 0x0000000D	An IEEE 1394 (FireWire) network.
NdisMediumInfiniBand 0x0000000E	An InfiniBand network.
NdisMediumTunnel 0x0000000F	A tunnel network.
NdisMediumNative802_11 0x00000010	A native IEEE 802.11 network.
NdisMediumLoopback 0x00000011	An NDIS loopback network.

NetNumber: The IPX network number that is matched to the destination network number in a packet's IPX header.

MacAddress: The destination MAC address of the IPX packet when it is forwarded to the next hop. For directly attached networks, the Forwarding MAC Address field is blank.

Delay: Link delay indicated in milliseconds.

Throughput: Throughput of the interface indicated in bits per second.

NetbiosAccept: This MUST be set to 0x00000001 for the interface to accept NetBIOS broadcast packets.

NetbiosDeliver: This MUST be set to 0x00000000 on the WAN interface and 0x00000001 on the LAN interface.

EnableIpxWanNegotiation: A value of 0x00000001 disables the WAN negotiation, and a value of 0x00000002 enables the WAN negotiation.

IfStats: The interface statistics. See IPX_IF_STATS (section 2.2.1.2.107).