MIB_IF_ROW2 estrutura

A estrutura MIB_IF_ROW2 armazena informações sobre uma interface específica.

Sintaxe

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;

Membros

InterfaceLuid
O identificador exclusivo local (LUID) para a interface de rede.
InterfaceIndex
O índice que identifica a interface de rede. Esse valor de índice pode mudar quando um adaptador de rede é desativado e, em seguida, habilitado, e não deve ser considerado persistente.
InterfaceGuid
O GUID para a interface de rede.
Alias
Uma cadeia de caracteres Unicode terminada por NULL que contém o nome do alias da interface de rede.
Descrição
Uma cadeia de caracteres Unicode terminada por NULL que contém uma descrição da interface de rede.
PhysicalAddressLength
O comprimento, em bytes, do endereço de hardware físico especificado pelo membro PhysicalAddress.
PhysicalAddress
O endereço físico de hardware do adaptador para esta interface de rede.
PermanentPhysicalAddress
O endereço de hardware físico permanente do adaptador para esta interface de rede.
Mtu
O tamanho máximo da unidade de transmissão (MTU), em bytes, para esta interface de rede.

Tipo
O tipo de interface conforme definido pela Internet Assigned Names Authority (IANA). Para obter mais informações, consulte IANAifType-MIB DEFINIÇÕES. Os valores possíveis para o tipo de interface estão listados no arquivo de cabeçalho Ipifcons.h.

A tabela a seguir lista valores comuns para o tipo de interface, embora muitos outros valores sejam possíveis.

Valor	Significado
IF_TYPE_OTHER 1	Algum outro tipo de interface de rede
IF_TYPE_ETHERNET_CSMACD 6	Uma interface de rede Ethernet
IF_TYPE_ISO88025_TOKENRING 9	Uma interface de rede token ring
IF_TYPE_PPP 23	Uma interface de rede PPP
IF_TYPE_SOFTWARE_LOOPBACK 24	Uma interface de rede de loopback de software
IF_TYPE_ATM 37	Uma interface de rede ATM
IF_TYPE_IEEE80211 71	Uma interface de rede sem fio IEEE 802.11
IF_TYPE_TUNNEL 131	Uma interface de rede de encapsulamento do tipo túnel
IF_TYPE_IEEE1394 144	Uma interface de rede de barramento serial de alto desempenho IEEE 1394 (Firewire)

TunnelType
Se o membro Type for IF_TYPE_TUNNEL, um tipo de TUNNEL_TYPE que define o método de encapsulamento que um túnel usa.

MediaType
O tipo de mídia NDIS para a interface. Esse membro pode ser um dos seguintes valores do tipo de enumeração NDIS_MEDIUM definido no arquivo de cabeçalho Ntddndis.h.

Valor	Significado
NdisMedium802_3 0	Uma rede Ethernet (802.3).
NdisMedium802_5 1	Uma rede Token Ring (802.5).
NdisMediumFddi 2	Uma rede FDDI (Fiber Distributed Data Interface).
NdisMediumWan 3	Uma rede de longa distância (WAN). Esse tipo abrange várias formas de NICs ponto a ponto e WAN e formatos de endereço/cabeçalho variantes que devem ser negociados entre o driver de protocolo e o driver subjacente após a ligação ser estabelecida.
NdisMediumLocalTalk 4	Uma rede LocalTalk.
NdisMediumDix 5	Uma rede Ethernet para a qual os drivers usam o formato de cabeçalho Ethernet DIX.
NdisMediumArcnetRaw 6	Uma rede ARCNET.
NdisMediumArcnet878_2 7	Uma rede ARCNET (878.2).
NdisMediumAtm 8	Uma rede ATM. Os drivers de protocolo de cliente orientados à conexão podem se vincular a um driver de miniporta subjacente que retorna esse valor. Caso contrário, os drivers de protocolo herdados se ligam ao driver intermediário LanE fornecido pelo sistema, que relata seu tipo médio como NdisMedium802_3 ou NdisMedium802_5, dependendo de como o administrador de rede configura o driver LanE.
NdisMediumWirelessWan 9	Uma rede sem fios. NDIS 5. x drivers de miniporta que suportam pacotes de LAN sem fio (WLAN) ou WAN sem fio (WWAN) declaram seu meio como NdisMedium802_3 e emulam Ethernet para drivers NDIS de nível mais alto. Observação Esse tipo de mídia não está disponível para uso no Windows Vista ou em versões posteriores do Windows.
NdisMediumIrda 10	Uma rede de infravermelhos (IrDA).
NdisMediumBpc 11	Uma rede de computadores de difusão.
NdisMediumCoWan 12	Uma rede de área ampla em um ambiente orientado à conexão.
NdisMedium1394 13	Uma rede IEEE 1394 (fire wire).
NdisMediumInfiniBand 14	Uma rede InfiniBand.
NdisMediumTunnel 15	Uma rede de túneis.
NdisMediumNative802_11 16	Uma rede IEEE 802.11 nativa.
NdisMediumLoopback 17	Uma rede de loopback NDIS.

PhysicalMediumType
O tipo de meio físico NDIS. Esse membro pode ser um dos seguintes valores do tipo de enumeração NDIS_PHYSICAL_MEDIUM definido no arquivo de cabeçalho Ntddndis.h.

Valor	Significado
NdisPhysicalMediumNão especificado 0	O meio físico não é nenhum dos seguintes valores. Por exemplo, uma alimentação via satélite unidirecional é um meio físico não especificado.
NdisPhysicalMediumWirelessLan 1	Os pacotes são transferidos através de uma rede LAN sem fio através de um driver de miniporta que está em conformidade com a interface 802.11.
NdisPhysicalMediumCableModem 2	Os pacotes são transferidos através de uma rede de cabo baseada em DOCSIS.
NdisPhysicalMediumPhoneLine 3	Os pacotes são transferidos através de linhas telefónicas padrão. Este tipo inclui mídia HomePNA.
NdisPhysicalMediumPowerLine 4	Os pacotes são transferidos através da cablagem que está ligada a um sistema de distribuição de energia.
NdisPhysicalMediumDSL 5	Os pacotes são transferidos através de uma rede DSL (Digital Subscriber Line). Este tipo inclui ADSL, UADSL (G.Lite) e SDSL.
NdisPhysicalMediumFibreChannel 6	Os pacotes são transferidos através de uma interconexão Fibre Channel.
NdisPhysicalMedium1394 7	Os pacotes são transferidos através de um barramento IEEE 1394.
NdisPhysicalMediumWirelessWan 8	Os pacotes são transferidos através de uma ligação WAN sem fios. Este tipo inclui CDPD, CDMA e GPRS.
NdisPhysicalMediumNative802_11 9	Os pacotes são transferidos através de uma rede LAN sem fio através de um driver de miniporta que está em conformidade com a interface nativa 802.11. Observação A interface nativa 802.11 é suportada no NDIS 6.0 e versões posteriores.
NdisPhysicalMediumBluetooth 10	Os pacotes são transferidos através de uma rede Bluetooth. O Bluetooth é uma tecnologia sem fios de curto alcance que utiliza o espectro de 2,4 GHz.
NdisPhysicalMediumInfiniband 11	Os pacotes são transferidos através de uma interconexão InfiniBand.
NdisPhysicalMediumUWB 13	Os pacotes são transferidos através de uma rede de banda ultra larga.
NdisPhysicalMedium802_3 14	Os pacotes são transferidos através de uma rede Ethernet (802.3).
NdisPhysicalMedium802_5 15	Os pacotes são transferidos através de uma rede Token Ring (802.5).
NdisPhysicalMediumIrda 16	Os pacotes são transferidos através de uma rede de infravermelhos (IrDA).
NdisPhysicalMediumWiredWAN 17	Os pacotes são transferidos através de uma rede WAN com fio.
NdisPhysicalMediumWiredCoWan 18	Os pacotes são transferidos através de uma rede de longa distância em um ambiente orientado à conexão.
NdisPhysicalMediumOutro 19	Os pacotes são transferidos através de uma rede que não é descrita por outros valores possíveis.

AccessType
Um NET_IF_ACCESS_TYPE tipo de acesso à interface de rede NDIS.
DirectionType
Um NET_IF_DIRECTION_TYPE tipo de direção de interface de rede NDIS.
InterfaceAndOperStatusFlags
Um conjunto dos seguintes sinalizadores que fornecem informações sobre a interface. Esses sinalizadores são combinados com uma operação bit a bit OR. Se nenhum dos sinalizadores se aplicar, este membro será definido como zero.
- HardwareInterface
  A interface de rede é para hardware.
- FilterInterface
  A interface de rede é para um módulo de filtro.
- ConnectorPresent
  Um conector está presente na interface de rede. Esse valor é definido se houver um adaptador de rede físico.
- NotAuthenticated
  A porta padrão para a interface de rede não é autenticada. Se uma interface de rede não for autenticada pelo destino, a interface de rede não estará em modo operacional. Embora essa situação se aplique a conexões de rede com e sem fio, a autenticação é mais comum para conexões de rede sem fio.
- NotMediaConnected
  A interface de rede não está em um estado conectado à mídia. Se um cabo de rede estiver desconectado de uma rede com fio, esse valor será definido. Para uma rede sem fio, esse valor é definido para o adaptador de rede que não está conectado a uma rede.
- Pausado
  A pilha de rede para a interface de rede está no estado pausado ou pausado. Esse valor não significa que o computador está em um estado de hibernação.
- LowPower
  A interface de rede está em um estado de baixa energia.
- EndPointInterface
  A interface de rede é um dispositivo de ponto de extremidade e não uma verdadeira interface de rede que se conecta a uma rede. Esse valor pode ser definido por dispositivos, como smartphones, que usam infraestrutura de rede para se comunicar com o computador, mas não fornecem conectividade a uma rede externa. Esses tipos de dispositivos devem definir esse sinalizador.
OperStatus
Um IF_OPER_STATUS tipo de status operacional da interface de rede NDIS.
AdminStatus
O NET_IF_ADMIN_STATUS tipo de status administrativo.
MediaConnectState
O NET_IF_MEDIA_CONNECT_STATE tipo de estado de conexão.
NetworkGuid
O GUID associado à rede à qual a interface pertence.
ConnectionType
Um NET_IF_CONNECTION_TYPE tipo de conexão de interface de rede NDIS.
TransmitLinkSpeed
A velocidade, em bits por segundo, do link de transmissão.
ReceiveLinkSpeed
A velocidade, em bits por segundo, do link de receção.
InOctets
O número de octetos de dados que são recebidos sem erros através desta interface. Esse valor inclui octetos em pacotes unicast, broadcast e multicast.
InUcastPkts
O número de pacotes unicast que são recebidos sem erros através desta interface.
InNUcastPkts
O número de pacotes não-unicast que são recebidos sem erros através desta interface. Esse valor inclui pacotes de difusão e multicast.
InDiscards
O número de pacotes de entrada que foram descartados mesmo que não tivessem erros.
InErrors
O número de pacotes de entrada que foram descartados devido a erros.
InUnknownProtos
O número de pacotes recebidos que foram descartados porque o protocolo era desconhecido.
InUcastOctets
O número de octetos de dados que são recebidos sem erros em pacotes unicast através desta interface.
InMulticastOctets
O número de octetos de dados que são recebidos sem erros em pacotes multicast através desta interface.
InBroadcastOctets
O número de octetos de dados que são recebidos sem erros em pacotes de difusão através desta interface.
OutOctets
O número de octetos de dados que são transmitidos sem erros através desta interface. Esse valor inclui octetos em pacotes unicast, broadcast e multicast.
OutUcastPkts
O número de pacotes unicast que são transmitidos sem erros através desta interface.
OutNUcastPkts
O número de pacotes não-unicast que são transmitidos sem erros através desta interface. Esse valor inclui pacotes de difusão e multicast.
OutDescarta
O número de pacotes de saída que foram descartados mesmo que não tivessem erros.
OutErrors
O número de pacotes de saída que foram descartados devido a erros.
OutUcastOctets
O número de octetos de dados que são transmitidos sem erros em pacotes unicast através desta interface.
OutMulticastOctets
O número de octetos de dados que são transmitidos sem erros em pacotes multicast através desta interface.
OutBroadcastOctets
O número de octetos de dados que são transmitidos sem erros em pacotes de difusão através desta interface.
OutQLen
O comprimento da fila de transmissão. Este campo não é utilizado atualmente.

Comentários

Os valores para o campo Tipo são definidos no arquivo de cabeçalho Ipifcons.h. Apenas os valores possíveis listados na descrição do membro Type são suportados no momento.