struttura MIB_IFROW (ifmib.h)

La struttura MIB_IFROW archivia informazioni su una particolare interfaccia.

Sintassi

typedef struct _MIB_IFROW {
  WCHAR                   wszName[MAX_INTERFACE_NAME_LEN];
  IF_INDEX                dwIndex;
  IFTYPE                  dwType;
  DWORD                   dwMtu;
  DWORD                   dwSpeed;
  DWORD                   dwPhysAddrLen;
  UCHAR                   bPhysAddr[MAXLEN_PHYSADDR];
  DWORD                   dwAdminStatus;
  INTERNAL_IF_OPER_STATUS dwOperStatus;
  DWORD                   dwLastChange;
  DWORD                   dwInOctets;
  DWORD                   dwInUcastPkts;
  DWORD                   dwInNUcastPkts;
  DWORD                   dwInDiscards;
  DWORD                   dwInErrors;
  DWORD                   dwInUnknownProtos;
  DWORD                   dwOutOctets;
  DWORD                   dwOutUcastPkts;
  DWORD                   dwOutNUcastPkts;
  DWORD                   dwOutDiscards;
  DWORD                   dwOutErrors;
  DWORD                   dwOutQLen;
  DWORD                   dwDescrLen;
  UCHAR                   bDescr[MAXLEN_IFDESCR];
} MIB_IFROW, *PMIB_IFROW;

Members

wszName[MAX_INTERFACE_NAME_LEN]

Tipo: WCHAR[MAX_INTERFACE_NAME_LEN]

Puntatore a una stringa Unicode contenente il nome dell'interfaccia.

dwIndex

Tipo: DWORD

Indice che identifica l'interfaccia. Questo valore di indice può cambiare quando una scheda di rete è disabilitata e quindi abilitata e non deve essere considerata persistente.

dwType

Tipo: DWORD

Tipo di interfaccia definito dall'autorità IANA (Internet Assigned Names Authority). Per altre informazioni, vedere http://www.iana.org/assignments/ianaiftype-mib. I valori possibili per il tipo di interfaccia sono elencati nel file di intestazione Ipifcons.h .

La tabella seguente elenca i valori comuni per il tipo di interfaccia anche se sono possibili molti altri valori.

Valore Significato
IF_TYPE_OTHER
1
Un altro tipo di interfaccia di rete.
IF_TYPE_ETHERNET_CSMACD
6
Interfaccia di rete Ethernet.
IF_TYPE_ISO88025_TOKENRING
9
Interfaccia di rete dell'anello del token.
IF_TYPE_FDDI
15
Interfaccia di rete FDDI (Fiber Distributed Data Interface).
IF_TYPE_PPP
23
Interfaccia di rete PPP.
IF_TYPE_SOFTWARE_LOOPBACK
24
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).
IF_TYPE_IEEE80216_WMAN
237
Interfaccia mobile broadband per i dispositivi WiMax.
Nota Questo tipo di interfaccia è supportato in Windows 7, Windows Server 2008 R2 e versioni successive.
 
IF_TYPE_WWANPP
243
Interfaccia mobile broadband per dispositivi basati su GSM.
Nota Questo tipo di interfaccia è supportato in Windows 7, Windows Server 2008 R2 e versioni successive.
 
IF_TYPE_WWANPP2
244
Interfaccia mobile broadband per i dispositivi basati su CDMA.
Nota Questo tipo di interfaccia è supportato in Windows 7, Windows Server 2008 R2 e versioni successive.
 

dwMtu

Tipo: DWORD

Dimensione massima dell'unità di trasmissione (MTU) in byte.

dwSpeed

Tipo: DWORD

Velocità dell'interfaccia in bit al secondo.

dwPhysAddrLen

Tipo: DWORD

Lunghezza, in byte, dell'indirizzo fisico specificato dal membro bPhysAddr .

bPhysAddr[MAXLEN_PHYSADDR]

Tipo: BYTE[MAXLEN_PHYSADDR]

Indirizzo fisico dell'adattatore per questa interfaccia.

dwAdminStatus

Tipo: DWORD

L'interfaccia è abilitata o disabilitata in modo amministrativo.

dwOperStatus

Tipo: DWORD

Stato operativo dell'interfaccia. Questo membro può essere uno dei valori seguenti definiti nell'enumerazione INTERNAL_IF_OPER_STATUS definita nel file di intestazione Ipifcons.h .

Valore Significato
IF_OPER_STATUS_NON_OPERATIONAL
La scheda LAN è stata disabilitata, ad esempio a causa di un conflitto di indirizzi.
IF_OPER_STATUS_UNREACHABLE
Scheda WAN non connessa.
IF_OPER_STATUS_DISCONNECTED
Per le schede LAN: cavo di rete disconnesso. Per le schede WAN: nessun gestore telefonico.
IF_OPER_STATUS_CONNECTING
Adattatore WAN in fase di connessione.
IF_OPER_STATUS_CONNECTED
Scheda WAN connessa a un peer remoto.
IF_OPER_STATUS_OPERATIONAL
Stato predefinito per le schede LAN

dwLastChange

Tipo: DWORD

Intervallo di tempo, in centesimi di secondi (10^-2 sec), a partire dall'ultimo riavvio del computer, quando l'interfaccia ha immesso lo stato operativo corrente. Questo valore esegue il roll over dopo 2^32 centesimi di secondo.

Il membro dwLastChange non è attualmente supportato da NDIS. In Windows Vista e versioni successive, NDIS restituisce zero per questo membro. Nelle versioni precedenti di Windows viene restituito un valore arbitrario in questo membro per le interfacce supportate da NDIS. Per le interfacce supportate da altri provider di interfaccia, possono restituire un valore appropriato.

dwInOctets

Tipo: DWORD

Numero di ottetti di dati ricevuti tramite questa interfaccia.

dwInUcastPkts

Tipo: DWORD

Numero di pacchetti unicast ricevuti tramite questa interfaccia.

dwInNUcastPkts

Tipo: DWORD

Numero di pacchetti non unicast ricevuti tramite questa interfaccia. Sono inclusi pacchetti broadcast e multicast.

dwInDiscards

Tipo: DWORD

Numero di pacchetti in ingresso che sono stati eliminati anche se non hanno errori.

dwInErrors

Tipo: DWORD

Numero di pacchetti in ingresso eliminati a causa di errori.

dwInUnknownProtos

Tipo: DWORD

Numero di pacchetti in ingresso eliminati perché il protocollo era sconosciuto.

dwOutOctets

Tipo: DWORD

Numero di ottetti di dati inviati tramite questa interfaccia.

dwOutUcastPkts

Tipo: DWORD

Numero di pacchetti unicast inviati tramite questa interfaccia.

dwOutNUcastPkts

Tipo: DWORD

Numero di pacchetti non unicast inviati tramite questa interfaccia. Sono inclusi pacchetti broadcast e multicast.

dwOutDiscards

Tipo: DWORD

Numero di pacchetti in uscita che sono stati eliminati anche se non hanno errori.

dwOutErrors

Tipo: DWORD

Numero di pacchetti in uscita eliminati a causa di errori.

dwOutQLen

Tipo: DWORD

Lunghezza della coda di trasmissione. Questo campo non è attualmente utilizzato.

dwDescrLen

Tipo: DWORD

Lunghezza, in byte, del membro bDescr .

bDescr[MAXLEN_IFDESCR]

Tipo: BYTE[MAXLEN_IFDESCR]

Descrizione dell'interfaccia.

Commenti

Il membro dwSpeed della struttura MIB_IFROW non sarà corretto per le interfacce di rete molto ad alta velocità (ad esempio 10 Gbit/s scheda di rete), poiché il valore massimo che può essere archiviato in un DWORD è 4.294.967.295. Le applicazioni devono usare la struttura MIB_IF_ROW2 restituita dalle funzioni GetIfEntry2 e GetIfTable2 o dalla struttura IP_ADAPTER_ADDRESSES restituita dalla funzione GetAdaptersAddresses per determinare la velocità per le interfacce di rete molto ad alta velocità.

In Microsoft Windows Software Development Kit (Windows SDK) (SDK) rilasciato per Windows Vista e versioni successive, l'organizzazione dei file di intestazione è stata modificata e la struttura MIB_IFROW è definita nel file di intestazione Ifmib.h non nel file di intestazione Iprtrmib.h. Si noti che il file di intestazione Ifmib.h viene automaticamente incluso in Iprtrmib.h , incluso automaticamente nel file di intestazione Iphlpapi.h . I file di intestazione Ifmib.h e Iprtrmib.h non devono mai essere usati direttamente.

Requisiti

Requisito Valore
Client minimo supportato Windows 2000 Professional [solo app desktop]
Server minimo supportato Windows 2000 Server [solo app desktop]
Intestazione ifmib.h (includere Iphlpapi.h)

Vedi anche

GetAdaptersAddresses

GetIfEntry

GetIfEntry2

IP_ADAPTER_ADDRESSES

MIB_IFSTATUS

MIB_IFTABLE

MIB_IF_TABLE2

MPR_INTERFACE_0