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.
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 .
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) |