estructura de MIB_IF_ROW2
La estructura MIB_IF_ROW2 almacena información sobre una interfaz determinada.
Sintaxis
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;
Miembros
InterfaceLuid
Identificador único local (LUID) de la interfaz de red.InterfaceIndex
Índice que identifica la interfaz de red. Este valor de índice puede cambiar cuando un adaptador de red está deshabilitado y, a continuación, habilitado, y no debe considerarse persistente.InterfaceGuid
GUID de la interfaz de red.Alias
Cadena Unicode terminada en NULL que contiene el nombre de alias de la interfaz de red.Descripción
Cadena Unicode terminada en NULL que contiene una descripción de la interfaz de red.PhysicalAddressLength
Longitud, en bytes, de la dirección de hardware física que especifica el miembro PhysicalAddress.PhysicalAddress
Dirección de hardware físico del adaptador para esta interfaz de red.PermanentePhysicalAddress
Dirección de hardware físico permanente del adaptador para esta interfaz de red.Mtu
Tamaño máximo de la unidad de transmisión (MTU), en bytes, para esta interfaz de red.Tipo
Tipo de interfaz definido por la Autoridad de nombres asignados a Internet (IANA). Para obtener más información, vea IANAifType-MIB DEFINITIONS. Los valores posibles para el tipo de interfaz se enumeran en el archivo de encabezado Ipifcons.h.En la tabla siguiente se enumeran los valores comunes para el tipo de interfaz, aunque muchos otros valores son posibles.
Valor Significado IF_TYPE_OTHER
1
Otro tipo de interfaz de red
IF_TYPE_ETHERNET_CSMACD
6
Una interfaz de red Ethernet
IF_TYPE_ISO88025_TOKENRING
9
Una interfaz de red de anillo de tokens
IF_TYPE_PPP
23
Una interfaz de red PPP
IF_TYPE_SOFTWARE_LOOPBACK
24
Una interfaz de red de bucle invertido de software
IF_TYPE_ATM
37
Una interfaz de red ATM
IF_TYPE_IEEE80211
71
Interfaz de red inalámbrica IEEE 802.11
IF_TYPE_TUNNEL
131
Interfaz de red de encapsulación de tipos de túnel
IF_TYPE_IEEE1394
144
Una interfaz de red de bus serie de alto rendimiento IEEE 1394 (Firewire)
TunnelType
Si el miembro Type está IF_TYPE_TUNNEL, un tipo de TUNNEL_TYPE que define el método de encapsulación que usa un túnel.MediaType
Tipo de medio NDIS para la interfaz. Este miembro puede ser uno de los siguientes valores del tipo de enumeración NDIS_MEDIUM definido en el archivo de encabezado Ntddndis.h.Valor Significado NdisMedium802_3
0
Una red Ethernet (802.3).
NdisMedium802_5
1
Una red de anillo de token (802.5).
NdisMediumFddi
2
Una red de interfaz de datos distribuida (FDDI) de fibra.
NdisMediumWan
3
Una red de área extensa (WAN). Este tipo abarca varias formas de NIC de punto a punto y WAN y formatos de dirección/encabezado variantes que se deben negociar entre el controlador de protocolo y el controlador subyacente después de establecer el enlace.
NdisMediumLocalTalk
4
Una red de LocalTalk.
NdisMediumDix
5
Una red Ethernet para la que los controladores usan el formato de encabezado Ethernet DIX.
NdisMediumArcnetRaw
6
Una red ARCNET.
NdisMediumArcnet878_2
7
Una red ARCNET (878.2).
NdisMediumAtm
8
Una red ATM. Los controladores de protocolo de cliente orientados a la conexión se pueden enlazar a un controlador de minipuerto subyacente que devuelve este valor. De lo contrario, los controladores de protocolo heredados se enlazan al controlador intermedio de LanE proporcionado por el sistema, que informa de su tipo medio como NdisMedium802_3 o NdisMedium802_5, en función de cómo el administrador de red configure el controlador LanE.
NdisMediumWirelessWan
9
Una red inalámbrica. NDIS 5. Los controladores miniporte x que admiten paquetes LAN inalámbricos (WLAN) o WAN inalámbrica (WWAN) declaran su medio como NdisMedium802_3 y emulan Ethernet a controladores NDIS de nivel superior.
Nota Este tipo de medio no está disponible para su uso en Windows Vista o versiones posteriores de Windows.
NdisMediumIrda
10
Una red de infrarrojos (IrDA).
NdisMediumBpc
11
Una red de equipo de difusión.
NdisMediumCoWan
12
Una red de área amplia en un entorno orientado a la conexión.
NdisMedium1394
13
Una red IEEE 1394 (cable de incendio).
NdisMediumInfiniBand
14
Una red InfiniBand.
NdisMediumTunnel
15
Una red de túnel.
NdisMediumNative802_11
16
Una red NATIVA IEEE 802.11.
NdisMediumLoopback
17
Una red de bucle invertido NDIS.
PhysicalMediumType
Tipo medio físico NDIS. Este miembro puede ser uno de los siguientes valores del tipo de enumeración NDIS_PHYSICAL_MEDIUM que se define en el archivo de encabezado Ntddndis.h.Value Significado NdisPhysicalMediumUnspecified
0
El medio físico no es ninguno de los valores siguientes. Por ejemplo, una fuente de satélite unidireccional es un medio físico no especificado.
NdisPhysicalMediumWirelessLan
1
Los paquetes se transfieren a través de una red LAN inalámbrica a través de un controlador de minipuerto que cumple con la interfaz 802.11.
NdisPhysicalMediumCableModem
2
Los paquetes se transfieren a través de una red de cable basada en DOCSIS.
NdisPhysicalMediumPhoneLine
3
Los paquetes se transfieren a través de líneas telefónicas estándar. Este tipo incluye medios HomePNA.
NdisPhysicalMediumPowerLine
4
Los paquetes se transfieren a través del cableado que está conectado a un sistema de distribución de energía.
NdisPhysicalMediumDSL
5
Los paquetes se transfieren a través de una red de línea de suscriptor digital (DSL). Este tipo incluye ADSL, UADSL (G.Lite) y SDSL.
NdisPhysicalMediumFibreChannel
6
Los paquetes se transfieren a través de una interconexión de canal de fibra.
NdisPhysicalMedium1394
7
Los paquetes se transfieren a través de un bus IEEE 1394.
NdisPhysicalMediumWirelessWan
8
Los paquetes se transfieren a través de un vínculo WAN inalámbrico. Este tipo incluye CDPD, EDITION y GPRS.
NdisPhysicalMediumNative802_11
9
Los paquetes se transfieren a través de una red LAN inalámbrica a través de un controlador de minipuerto que cumple con la interfaz Native 802.11.
Nota La interfaz Native 802.11 es compatible con NDIS 6.0 y versiones posteriores.
NdisPhysicalMediumBluetooth
10
Los paquetes se transfieren a través de una red Bluetooth. Bluetooth es una tecnología inalámbrica de corto alcance que utiliza el espectro de 2,4 GHz.
NdisPhysicalMediumInfiniband
11
Los paquetes se transfieren a través de una interconexión InfiniBand.
NdisPhysicalMediumUWB
13
Los paquetes se transfieren a través de una red de banda ultra ancha.
NdisPhysicalMedium802_3
14
Los paquetes se transfieren a través de una red Ethernet (802.3).
NdisPhysicalMedium802_5
15
Los paquetes se transfieren a través de una red de anillo de tokens (802.5).
NdisPhysicalMediumIrda
16
Los paquetes se transfieren a través de una red de infrarrojos (IrDA).
NdisPhysicalMediumWiredWAN
17
Los paquetes se transfieren a través de una red WAN cableada.
NdisPhysicalMediumWiredCoWan
18
Los paquetes se transfieren a través de una red de área extensa en un entorno orientado a la conexión.
NdisPhysicalMediumOther
19
Los paquetes se transfieren a través de una red que no se describe con otros valores posibles.
AccessType
Tipo de acceso de interfaz de red NDIS NET_IF_ACCESS_TYPE.DirectionType
Un NET_IF_DIRECTION_TYPE tipo de dirección de la interfaz de red NDIS.InterfaceAndOperStatusFlags
Conjunto de las marcas siguientes que proporcionan información sobre la interfaz. Estas marcas se combinan con una operación OR bit a bit. Si no se aplica ninguna de las marcas, este miembro se establece en cero.HardwareInterface
La interfaz de red es para hardware.FilterInterface
La interfaz de red es para un módulo de filtro.ConnectorPresent
Hay un conector presente en la interfaz de red. Este valor se establece si hay un adaptador de red físico.NotAuthenticated
El puerto predeterminado de la interfaz de red no se autentica. Si el destino no autentica una interfaz de red, la interfaz de red no está en modo operativo. Aunque esta situación se aplica a las conexiones de red cableadas e inalámbricas, la autenticación es más común para las conexiones de red inalámbrica.NotMediaConnected
La interfaz de red no está en estado conectado a medios. Si un cable de red está desconectado para una red cableada, se establece este valor. Para una red inalámbrica, este valor se establece para el adaptador de red que no está conectado a una red.En pausa
La pila de red de la interfaz de red está en estado en pausa o pausa. Este valor no significa que el equipo esté en estado hibernado.LowPower
La interfaz de red está en un estado de bajo consumo.EndPointInterface
La interfaz de red es un dispositivo de punto de conexión y no una verdadera interfaz de red que se conecta a una red. Este valor se puede establecer mediante dispositivos, como smartphones, que usan la infraestructura de red para comunicarse con el equipo, pero no proporcionan conectividad a una red externa. Estos tipos de dispositivos deben establecer esta marca.
OperStatus
Tipo de estado operativo IF_OPER_STATUS interfaz de red NDIS.AdminStatus
Tipo de estado administrativo NET_IF_ADMIN_STATUS .MediaConnectState
Tipo de estado de conexión NET_IF_MEDIA_CONNECT_STATE.NetworkGuid
GUID asociado a la red a la que pertenece la interfaz.ConnectionType
Un NET_IF_CONNECTION_TYPE tipo de conexión de interfaz de red NDIS.TransmitLinkSpeed
Velocidad, en bits por segundo, del enlace de transmisión.ReceiveLinkSpeed
Velocidad, en bits por segundo, del vínculo de recepción.InOctets
Número de octetos de datos que se reciben sin errores a través de esta interfaz. Este valor incluye octetos en paquetes de unidifusión, difusión y multidifusión.InUcastPkts
Número de paquetes de unidifusión que se reciben sin errores a través de esta interfaz.InNUcastPkts
Número de paquetes que no son de unidifusión que se reciben sin errores a través de esta interfaz. Este valor incluye paquetes de difusión y multidifusión.InDiscards
Número de paquetes entrantes que se descartaron aunque no tenían errores.InErrors
Número de paquetes entrantes que se descartaron debido a errores.InUnknownProtos
Número de paquetes entrantes que se descartaron porque se desconoce el protocolo.InUcastOctets
Número de octetos de datos que se reciben sin errores en paquetes de unidifusión a través de esta interfaz.InMulticastOctets
Número de octetos de datos que se reciben sin errores en paquetes de multidifusión a través de esta interfaz.InBroadcastOctets
Número de octetos de datos que se reciben sin errores en los paquetes de difusión a través de esta interfaz.OutOctets
Número de octetos de datos que se transmiten sin errores a través de esta interfaz. Este valor incluye octetos en paquetes de unidifusión, difusión y multidifusión.OutUcastPkts
Número de paquetes de unidifusión que se transmiten sin errores a través de esta interfaz.OutNUcastPkts
Número de paquetes que no son de unidifusión que se transmiten sin errores a través de esta interfaz. Este valor incluye paquetes de difusión y multidifusión.OutDiscards
El número de paquetes salientes que se descartaron aunque no tuvieran errores.OutErrors
Número de paquetes salientes que se descartaron debido a errores.OutUcastOctets
Número de octetos de datos que se transmiten sin errores en paquetes de unidifusión a través de esta interfaz.OutMulticastOctets
Número de octetos de datos que se transmiten sin errores en paquetes de multidifusión a través de esta interfaz.OutBroadcastOctets
Número de octetos de datos que se transmiten sin errores en los paquetes de difusión a través de esta interfaz.OutQLen
Longitud de la cola de transmisión. Este campo no se usa actualmente.
Observaciones
Los valores del campo Tipo se definen en el archivo de encabezado Ipifcons.h. Actualmente solo se admiten los valores posibles que aparecen en la descripción del miembro Type.
Requisitos
Versión |
Disponible en Windows Vista y versiones posteriores de los sistemas operativos Windows. |
Encabezado |
Netioapi.h (incluya Netioapi.h) |