estrutura MIB_IF_ROW2
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 LUID (identificador exclusivo local) para o adaptador de rede.Interfaceindex
O índice que identifica o adaptador de rede. Esse valor de índice pode ser alterado quando um adaptador de rede é desabilitado e habilitado e não deve ser considerado persistente.InterfaceGuid
O GUID para o adaptador de rede.Alias
Uma cadeia de caracteres Unicode terminada em NULL que contém o nome do alias do adaptador de rede.Descrição
Uma cadeia de caracteres Unicode terminada em NULL que contém uma descrição do adaptador de rede.PhysicalAddressLength
O comprimento, em bytes, do endereço de hardware físico especificado pelo membro PhysicalAddress.Physicaladdress
O endereço de hardware físico do adaptador para esse adaptador de rede.PermanentPhysicalAddress
O endereço de hardware físico permanente do adaptador para esse adaptador de rede.Mtu
O tamanho máximo da MTU (unidade de transmissão), em bytes, para esse adaptador de rede.Tipo
O tipo de interface conforme definido pela IANA (Autoridade de Nomes Atribuídos à Internet). Para obter mais informações, consulte DEFINIÇÕES DE IANAifType-MIB. Os valores possíveis para o tipo de interface sã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
Um adaptador de rede Ethernet
IF_TYPE_ISO88025_TOKENRING
9
Um adaptador de rede de anel de token
IF_TYPE_PPP
23
Um adaptador de rede PPP
IF_TYPE_SOFTWARE_LOOPBACK
24
Um adaptador de rede de loopback de software
IF_TYPE_ATM
37
Um adaptador de rede atm
IF_TYPE_IEEE80211
71
Um adaptador de rede sem fio IEEE 802.11
IF_TYPE_TUNNEL
131
Um adaptador de rede de encapsulamento de tipo de túnel
IF_TYPE_IEEE1394
144
Um adaptador de rede de barramento serial de alto desempenho do 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 de Anel de Token (802.5).
NdisMediumFddi
2
Uma rede FDDI (Interface de Dados Distribuídos de Fibra).
NdisMediumWan
3
Uma WAN (rede de ampla área). Esse tipo abrange várias formas de NICs ponto a ponto e WAN e formatos de endereço/cabeçalho variante que devem ser negociados entre o driver de protocolo e o driver subjacente após a associação ser estabelecida.
NdisMediumLocalTalk
4
Uma rede LocalTalk.
NdisMediumDix
5
Uma rede Ethernet para a qual os drivers usam o formato de cabeçalho DIX Ethernet.
NdisMediumArcnetRaw
6
Uma rede ARCNET.
NdisMediumArcnet878_2
7
Uma rede ARCNET (878.2).
NdisMediumAtm
8
Uma rede de caixas eletrônicos. Os drivers de protocolo de cliente orientados para conexão podem se associar a um driver de miniporto subjacente que retorna esse valor. Caso contrário, os drivers de protocolo herdados se associam 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 fio. NDIS 5. X miniport drivers que dão suporte a pacotes WLAN (LAN sem fio) ou WWAN (WAN sem fio) declaram seu meio como NdisMedium802_3 e emulam ethernet para drivers NDIS de nível superior.
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 infravermelha (IrDA).
NdisMediumBpc
11
Uma rede de computador de difusão.
NdisMediumCoWan
12
Uma rede de longa distância em um ambiente orientado a conexões.
NdisMedium1394
13
Uma rede IEEE 1394 (transmissão de fogo).
NdisMediumInfiniBand
14
Uma rede InfiniBand.
NdisMediumTunnel
15
Uma rede de túnel.
NdisMediumNative802_11
16
Uma rede nativa do IEEE 802.11.
NdisMediumLoopback
17
Uma rede de loopback NDIS.
PhysicalMediumType
O tipo médio físico do 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 NdisPhysicalMediumUnspecified
0
O meio físico não é nenhum dos valores a seguir. Por exemplo, uma alimentação via satélite unidirecional é um meio físico não especificado.
NdisPhysicalMediumWirelessLan
1
Os pacotes são transferidos por uma rede LAN sem fio por meio de um driver de miniporta que está em conformidade com a interface 802.11.
NdisPhysicalMediumCableModem
2
Os pacotes são transferidos por uma rede de cabo baseada em DOCSIS.
NdisPhysicalMediumPhoneLine
3
Os pacotes são transferidos por linhas telefônicas padrão. Esse tipo inclui a mídia HomePNA.
NdisPhysicalMediumPowerLine
4
Os pacotes são transferidos pela fiação conectada a um sistema de distribuição de energia.
NdisPhysicalMediumDSL
5
Os pacotes são transferidos por uma rede DSL (Linha de Assinante Digital). Esse tipo inclui ADSL, UADSL (G.Lite) e SDSL.
NdisPhysicalMediumFibreChannel
6
Os pacotes são transferidos por meio de uma interconexão fibre channel.
NdisPhysicalMedium1394
7
Os pacotes são transferidos por um ônibus IEEE 1394.
NdisPhysicalMediumWirelessWan
8
Os pacotes são transferidos por meio de um link wan sem fio. Esse tipo inclui CDPD, CDMA e GPRS.
NdisPhysicalMediumNative802_11
9
Os pacotes são transferidos por uma rede LAN sem fio por meio de um driver de miniporta que está em conformidade com a interface Native 802.11.
Observação A interface Nativa 802.11 tem suporte no NDIS 6.0 e versões posteriores.
NdisPhysicalMediumBluetooth
10
Os pacotes são transferidos por uma rede Bluetooth. O Bluetooth é uma tecnologia sem fio de curto alcance que usa o espectro de 2,4 GHz.
NdisPhysicalMediumInfiniband
11
Os pacotes são transferidos por meio de uma interconexão InfiniBand.
NdisPhysicalMediumUWB
13
Os pacotes são transferidos por uma rede de banda ultra wide.
NdisPhysicalMedium802_3
14
Os pacotes são transferidos por uma rede Ethernet (802.3).
NdisPhysicalMedium802_5
15
Os pacotes são transferidos por meio de uma rede de Anel de Token (802.5).
NdisPhysicalMediumIrda
16
Os pacotes são transferidos por uma rede infravermelha (IrDA).
NdisPhysicalMediumWiredWAN
17
Os pacotes são transferidos por uma rede WAN com fio.
NdisPhysicalMediumWiredCoWan
18
Os pacotes são transferidos por uma rede de longa distância em um ambiente orientado a conexão.
NdisPhysicalMediumOther
19
Os pacotes são transferidos por uma rede que não é descrita por outros valores possíveis.
AccessType
Um NET_IF_ACCESS_TYPE tipo de acesso de adaptador de rede NDIS.DirectionType
Um NET_IF_DIRECTION_TYPE tipo de direção de interface de rede NDIS.InterfaceAndOperStatusFlags
Um conjunto dos sinalizadores a seguir que fornecem informações sobre a interface. Esses sinalizadores são combinados com uma operação OR bit a bit. Se nenhum dos sinalizadores se aplicar, esse membro será definido como zero.HardwareInterface
O adaptador de rede é para hardware.FilterInterface
O adaptador de rede é para um módulo de filtro.ConnectorPresent
Um conector está presente no adaptador de rede. Esse valor será definido se houver um adaptador de rede física.NotAuthenticated
A porta padrão para o adaptador de rede não é autenticada. Se um adaptador de rede não for autenticado pelo destino, o adaptador de rede não estará em um 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
O adaptador de rede não está em um estado conectado à mídia. Se um cabo de rede estiver desconectado para 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.Em pausa
A pilha de rede do adaptador de rede está em pausa ou em pausa. Esse valor não significa que o computador esteja em um estado hibernado.LowPower
O adaptador de rede está em um estado de baixa energia.EndPointInterface
O adaptador de rede é um dispositivo de ponto de extremidade e não um adaptador de rede verdadeiro que se conecta a uma rede. Esse valor pode ser definido por dispositivos, como smartphones, que usam a infraestrutura de rede para se comunicar com o computador, mas não fornecem conectividade com uma rede externa. Esses tipos de dispositivos devem definir esse sinalizador.
OperStatus
Um tipo de status operacional do adaptador de rede NDIS IF_OPER_STATUS.AdminStatus
O NET_IF_ADMIN_STATUS tipo de status administrativa.MediaConnectState
O tipo de estado de conexão NET_IF_MEDIA_CONNECT_STATE.NetworkGuid
O GUID associado à rede à qual a interface pertence.ConnectionType
Um NET_IF_CONNECTION_TYPE tipo de conexão de adaptador 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 recebimento.InOctets
O número de octetos de dados recebidos sem erros por meio dessa interface. Esse valor inclui octetos em pacotes unicast, difusão e multicast.InUcastPkts
O número de pacotes unicast recebidos sem erros por meio dessa interface.InNUcastPkts
O número de pacotes não unicast recebidos sem erros por meio dessa 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 tenham erros.InErrors
O número de pacotes de entrada que foram descartados devido a erros.InUnknownProtos
O número de pacotes de entrada que foram descartados porque o protocolo era desconhecido.InUcastOctets
O número de octetos de dados recebidos sem erros em pacotes unicast por meio dessa interface.InMulticastOctets
O número de octetos de dados recebidos sem erros em pacotes multicast por meio dessa interface.InBroadcastOctets
O número de octetos de dados recebidos sem erros em pacotes de difusão por meio dessa interface.OutOctets
O número de octetos de dados transmitidos sem erros por meio dessa interface. Esse valor inclui octetos em pacotes unicast, difusão e multicast.OutUcastPkts
O número de pacotes unicast transmitidos sem erros por meio dessa interface.OutNUcastPkts
O número de pacotes não unicast que são transmitidos sem erros por meio dessa interface. Esse valor inclui pacotes de difusão e multicast.OutDiscards
O número de pacotes de saída que foram descartados mesmo que não tenham erros.OutErrors
O número de pacotes de saída que foram descartados devido a erros.OutUcastOctets
O número de octetos de dados transmitidos sem erros em pacotes unicast por meio dessa interface.OutMulticastOctets
O número de octetos de dados transmitidos sem erros em pacotes multicast por meio dessa interface.OutBroadcastOctets
O número de octetos de dados transmitidos sem erros em pacotes de difusão por meio dessa interface.OutQLen
O comprimento da fila de transmissão. Este campo não é usado no momento.
Comentários
Os valores do campo Tipo são definidos no arquivo de cabeçalho Ipifcons.h. No momento, há suporte apenas para os valores possíveis listados na descrição do membro Type.
Requisitos
Versão |
Disponível no Windows Vista e versões posteriores dos sistemas operacionais Windows. |
Cabeçalho |
Netioapi.h (inclua Netioapi.h) |