struttura MIB_IF_ROW2
La struttura MIB_IF_ROW2 archivia informazioni su una particolare interfaccia.
Sintassi
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;
Members
InterfaceLuid
Identificatore univoco locale (LUID) per l'interfaccia di rete.InterfaceIndex
Indice che identifica l'interfaccia di rete. Questo valore di indice può cambiare quando una scheda di rete è disabilitata e quindi abilitata e non deve essere considerata persistente.InterfaceGuid
GUID per l'interfaccia di rete.Alias
Stringa Unicode con terminazione NULL contenente il nome alias dell'interfaccia di rete.Descrizione
Stringa Unicode con terminazione NULL contenente una descrizione dell'interfaccia di rete.PhysicalAddressLength
Lunghezza, in byte, dell'indirizzo hardware fisico specificato dal membro PhysicalAddress.PhysicalAddress
Indirizzo hardware fisico della scheda per questa interfaccia di rete.PermanentPhysicalAddress
Indirizzo hardware fisico permanente della scheda per questa interfaccia di rete.Mtu
Dimensione massima dell'unità di trasmissione (MTU) in byte per questa interfaccia di rete.Tipo
Tipo di interfaccia definito dall'autorità IANA (Internet Assigned Names Authority). Per altre informazioni, vedere DEFINIZIONi IANAifType-MIB. I valori possibili per il tipo di interfaccia sono elencati nel file di intestazione Ipifcons.h.Nella tabella seguente sono elencati i valori comuni per il tipo di interfaccia, anche se sono possibili molti altri valori.
Valore Significato IF_TYPE_OTHER
1
Altri tipi di interfaccia di rete
IF_TYPE_ETHERNET_CSMACD
6
Interfaccia di rete Ethernet
IF_TYPE_ISO88025_TOKENRING
9
Interfaccia di rete dell'anello di token
IF_TYPE_PPP
23
Un'interfaccia di rete PPP
IF_TYPE_SOFTWARE_LOOPBACK
24
Un'interfaccia di rete di loopback software
IF_TYPE_ATM
37
Interfaccia di rete ATM
IF_TYPE_IEEE80211
71
Interfaccia di rete wireless IEEE 802.11
IF_TYPE_TUNNEL
131
Interfaccia di rete incapsulamento del tipo di tunnel
IF_TYPE_IEEE1394
144
Interfaccia di rete del bus seriale IEEE 1394 (Firewire) a prestazioni elevate
TunnelType
Se il membro Type è IF_TYPE_TUNNEL, un tipo TUNNEL_TYPE che definisce il metodo di incapsulamento utilizzato da un tunnel.MediaType
Tipo di supporto NDIS per l'interfaccia. Questo membro può essere uno dei valori seguenti dal tipo di enumerazione NDIS_MEDIUM definito nel file di intestazione Ntddndis.h.Valore Significato NdisMedium802_3
0
Una rete Ethernet (802.3).
NdisMedium802_5
1
Una rete Token Ring (802.5).
NdisMediumFddi
2
Una rete FDDI (Fiber Distributed Data Interface).
NdisMediumWan
3
Una rete WAN (Wide Area Network). Questo tipo copre varie forme di schede di interfaccia di rete point-to-point e WAN e formati di indirizzo/intestazione varianti che devono essere negoziati tra il driver di protocollo e il driver sottostante dopo che è stata stabilita l'associazione.
NdisMediumLocalTalk
4
Una rete LocalTalk.
NdisMediumDix
5
Rete Ethernet per cui i driver usano il formato di intestazione Ethernet DIX.
NdisMediumArcnetRaw
6
Una rete ARCNET.
NdisMediumArcnet878_2
7
Una rete ARCNET (878.2).
NdisMediumAtm
8
Una rete ATM. I driver del protocollo client orientati alla connessione possono associarsi a un driver miniport sottostante che restituisce questo valore. In caso contrario, i driver di protocollo legacy si associano al driver intermedio LanE fornito dal sistema, che segnala il tipo medio come NdisMedium802_3 o NdisMedium802_5, a seconda del modo in cui l'amministratore di rete configura il driver LanE.
NdisMediumWirelessWan
9
Una rete wireless. NDIS 5. i driver miniport x che supportano pacchetti LAN wireless (WLAN) o WAN wireless (WWAN) dichiarano il supporto come NdisMedium802_3 ed emulare Ethernet a driver NDIS di livello superiore.
Nota Questo tipo di supporto non è disponibile per l'uso in Windows Vista o versioni successive di Windows.
NdisMediumIrda
10
Una rete a infrarossi (IrDA).
NdisMediumBpc
11
Una rete di computer broadcast.
NdisMediumCoWan
12
Una rete wide area in un ambiente orientato alla connessione.
NdisMedium1394
13
Una rete IEEE 1394 (filo antincendio).
NdisMediumInfiniBand
14
Una rete InfiniBand.
NdisMediumTunnel
15
Una rete tunnel.
NdisMediumNative802_11
16
Una rete IEEE 802.11 nativa.
NdisMediumLoopback
17
Una rete di loopback NDIS.
PhysicalMediumType
Tipo di supporto fisico NDIS. Questo membro può essere uno dei valori seguenti dal tipo di enumerazione NDIS_PHYSICAL_MEDIUM definito nel file di intestazione Ntddndis.h.Valore Significato NdisPhysicalMediumUnspecified
0
Il supporto fisico non è uno dei valori seguenti. Ad esempio, un feed satellite unidirezionale è un supporto fisico non specificato.
NdisPhysicalMediumWirelessLan
1
I pacchetti vengono trasferiti tramite una rete LAN wireless tramite un driver miniport conforme all'interfaccia 802.11.
NdisPhysicalMediumCableModem
2
I pacchetti vengono trasferiti tramite una rete cablare basata su DOCSIS.
NdisPhysicalMediumPhoneLine
3
I pacchetti vengono trasferiti su linee telefoniche standard. Questo tipo include i supporti HomePNA.
NdisPhysicalMediumPowerLine
4
I pacchetti vengono trasferiti tramite cablaggio connesso a un sistema di distribuzione dell'alimentazione.
NdisPhysicalMediumDSL
5
I pacchetti vengono trasferiti tramite una rete DSL (Digital Subscriber Line). Questo tipo include LA LIBRERIA, UADSL (G.Lite) e SDSL.
NdisPhysicalMediumFibreChannel
6
I pacchetti vengono trasferiti tramite un'interconnessione Fibre Channel.
NdisPhysicalMedium1394
7
I pacchetti vengono trasferiti su un bus IEEE 1394.
NdisPhysicalMediumWirelessWan
8
I pacchetti vengono trasferiti tramite un collegamento WAN wireless. Questo tipo include CDPD, CDMA e GSMS.
NdisPhysicalMediumNative802_11
9
I pacchetti vengono trasferiti tramite una rete LAN wireless tramite un driver miniport conforme all'interfaccia Native 802.11.
Nota L'interfaccia nativa 802.11 è supportata in NDIS 6.0 e versioni successive.
NdisPhysicalMediumBluetooth
10
I pacchetti vengono trasferiti tramite una rete Bluetooth. Bluetooth è una tecnologia wireless a corto raggio che usa lo spettro a 2,4 GHz.
NdisPhysicalMediumInfiniband
11
I pacchetti vengono trasferiti tramite un'interconnessione InfiniBand.
NdisPhysicalMediumUWB
13
I pacchetti vengono trasferiti tramite una rete ultra wide band.
NdisPhysicalMedium802_3
14
I pacchetti vengono trasferiti tramite una rete Ethernet (802.3).
NdisPhysicalMedium802_5
15
I pacchetti vengono trasferiti tramite una rete Token Ring (802.5).
NdisPhysicalMediumIrda
16
I pacchetti vengono trasferiti tramite una rete irDA (Infrarossi).
NdisPhysicalMediumWiredWAN
17
I pacchetti vengono trasferiti tramite una rete WAN cablata.
NdisPhysicalMediumWiredCoWan
18
I pacchetti vengono trasferiti tramite una rete estesa in un ambiente orientato alla connessione.
NdisPhysicalMediumOther
19
I pacchetti vengono trasferiti in una rete non descritta da altri valori possibili.
AccessType
Tipo di accesso all'interfaccia di rete NDIS NET_IF_ACCESS_TYPE.DirectionType
Tipo di direzione dell'interfaccia di rete NDIS NET_IF_DIRECTION_TYPE.InterfaceAndOperStatusFlags
Set di flag seguenti che forniscono informazioni sull'interfaccia. Questi flag vengono combinati con un'operazione OR bit per bit. Se nessuno dei flag si applica, questo membro è impostato su zero.HardwareInterface
L'interfaccia di rete è per l'hardware.FilterInterface
L'interfaccia di rete è per un modulo di filtro.ConnectorPresent
Un connettore è presente nell'interfaccia di rete. Questo valore viene impostato se è presente una scheda di rete fisica.NotAuthenticated
La porta predefinita per l'interfaccia di rete non è autenticata. Se un'interfaccia di rete non è autenticata dalla destinazione, l'interfaccia di rete non è in modalità operativa. Anche se questa situazione si applica sia alle connessioni di rete cablata che wireless, l'autenticazione è più comune per le connessioni di rete wireless.NotMediaConnected
L'interfaccia di rete non è in uno stato connesso a supporti. Se un cavo di rete viene scollegato per una rete cablata, questo valore viene impostato. Per una rete wireless, questo valore è impostato per la scheda di rete che non è connessa a una rete.Sospeso
Lo stack di rete per l'interfaccia di rete si trova nello stato sospeso o in pausa. Questo valore non significa che il computer si trova in uno stato ibernato.Bassa potenza
L'interfaccia di rete si trova in uno stato di bassa potenza.EndPointInterface
L'interfaccia di rete è un dispositivo endpoint e non una vera interfaccia di rete che si connette a una rete. Questo valore può essere impostato dai dispositivi, ad esempio smartphone, che usano l'infrastruttura di rete per comunicare al computer, ma non fornire la connettività a una rete esterna. Questi tipi di dispositivi devono impostare questo flag.
OperStatus
Tipo di stato operativo dell'interfaccia di rete NDIS IF_OPER_STATUS.AdminStatus
Tipo di stato amministrativo NET_IF_ADMIN_STATUS.MediaConnectState
Tipo di stato della connessione NET_IF_MEDIA_CONNECT_STATE .NetworkGuid
GUID associato alla rete a cui appartiene l'interfaccia.ConnectionType
Tipo di connessione dell'interfaccia di rete NDIS NET_IF_CONNECTION_TYPE.TransmitLinkSpeed
Velocità, in bit al secondo, del collegamento di trasmissione.ReceiveLinkSpeed
Velocità, in bit al secondo, del collegamento di ricezione.InOctets
Numero di ottetti di dati ricevuti senza errori tramite questa interfaccia. Questo valore include ottetti in pacchetti unicast, broadcast e multicast.InUcastPkts
Numero di pacchetti unicast ricevuti senza errori tramite questa interfaccia.InNUcastPkts
Numero di pacchetti non unicast ricevuti senza errori tramite questa interfaccia. Questo valore include pacchetti broadcast e multicast.InDiscards
Numero di pacchetti in ingresso eliminati anche se non hanno errori.InErrors
Numero di pacchetti in ingresso eliminati a causa di errori.InUnknownProtos
Numero di pacchetti in ingresso eliminati perché il protocollo è sconosciuto.InUcastOctets
Numero di ottetti di dati ricevuti senza errori nei pacchetti unicast tramite questa interfaccia.InMulticastOctets
Numero di ottetti di dati ricevuti senza errori nei pacchetti multicast tramite questa interfaccia.InBroadcastOctets
Numero di ottetti di dati ricevuti senza errori nei pacchetti di trasmissione tramite questa interfaccia.OutOctet
Numero di ottetti di dati trasmessi senza errori tramite questa interfaccia. Questo valore include ottetti in pacchetti unicast, broadcast e multicast.OutUcastPkts
Numero di pacchetti unicast trasmessi senza errori tramite questa interfaccia.OutNUcastPkts
Numero di pacchetti non unicast trasmessi senza errori tramite questa interfaccia. Questo valore include pacchetti broadcast e multicast.OutDiscards
Numero di pacchetti in uscita eliminati anche se non hanno avuto errori.OutErrors
Numero di pacchetti in uscita eliminati a causa di errori.OutUcastOctets
Numero di ottetti di dati trasmessi senza errori nei pacchetti unicast tramite questa interfaccia.OutMulticastOctets
Numero di ottetti di dati trasmessi senza errori nei pacchetti multicast tramite questa interfaccia.OutBroadcastOctets
Numero di ottetti di dati trasmessi senza errori nei pacchetti di trasmissione tramite questa interfaccia.OutQLen
Lunghezza della coda di trasmissione. Questo campo non viene attualmente usato.
Commenti
I valori per il campo Type sono definiti nel file di intestazione Ipifcons.h. Sono attualmente supportati solo i valori possibili elencati nella descrizione del membro Type.
Requisiti
Versione |
Disponibile in Windows Vista e versioni successive dei sistemi operativi Windows. |
Intestazione |
Netioapi.h (include Netioapi.h) |