structure MIB_IFROW (ifmib.h)
La structure MIB_IFROW stocke des informations sur une interface particulière.
Syntaxe
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;
Membres
wszName[MAX_INTERFACE_NAME_LEN]
Type : WCHAR[MAX_INTERFACE_NAME_LEN]
Pointeur vers une chaîne Unicode qui contient le nom de l’interface.
dwIndex
Type : DWORD
Index qui identifie l’interface. Cette valeur d’index peut changer lorsqu’une carte réseau est désactivée, puis activée, et ne doit pas être considérée comme persistante.
dwType
Type : DWORD
Type d’interface tel que défini par l’IANA (Internet Assigned Names Authority). Pour plus d’informations, consultez http://www.iana.org/assignments/ianaiftype-mib. Les valeurs possibles pour le type d’interface sont répertoriées dans le fichier d’en-tête Ipifcons.h .
Le tableau ci-dessous répertorie les valeurs communes pour le type d’interface, bien que de nombreuses autres valeurs soient possibles.
dwMtu
Type : DWORD
Taille maximale de l’unité de transmission (MTU) en octets.
dwSpeed
Type : DWORD
Vitesse de l’interface en bits par seconde.
dwPhysAddrLen
Type : DWORD
Longueur, en octets, de l’adresse physique spécifiée par le membre bPhysAddr .
bPhysAddr[MAXLEN_PHYSADDR]
Type : BYTE[MAXLEN_PHYSADDR]
Adresse physique de l’adaptateur pour cette interface.
dwAdminStatus
Type : DWORD
L’interface est activée ou désactivée par l’administration.
dwOperStatus
Type : DWORD
Status opérationnelle de l’interface. Ce membre peut être l’une des valeurs suivantes définies dans l’énumération INTERNAL_IF_OPER_STATUS définie dans le fichier d’en-tête Ipifcons.h .
dwLastChange
Type : DWORD
Durée, en centièmes de secondes (10^-2 secondes), à partir du dernier redémarrage de l’ordinateur, lorsque l’interface est entrée dans son état opérationnel actuel. Cette valeur est remplacée après 2^32 centièmes de seconde.
Le membre dwLastChange n’est actuellement pas pris en charge par NDIS. Sur Windows Vista et versions ultérieures, NDIS retourne zéro pour ce membre. Sur les versions antérieures de Windows, une valeur arbitraire est retournée dans ce membre pour les interfaces prises en charge par NDIS. Pour les interfaces prises en charge par d’autres fournisseurs d’interface, elles peuvent retourner une valeur appropriée.
dwInOctets
Type : DWORD
Nombre d’octets de données reçus via cette interface.
dwInUcastPkts
Type : DWORD
Nombre de paquets de monodiffusion reçus via cette interface.
dwInNUcastPkts
Type : DWORD
Nombre de paquets non unicast reçus via cette interface. Les paquets de diffusion et de multidiffusion sont inclus.
dwInDiscards
Type : DWORD
Nombre de paquets entrants qui ont été ignorés même s’ils n’avaient pas d’erreurs.
dwInErrors
Type : DWORD
Nombre de paquets entrants qui ont été ignorés en raison d’erreurs.
dwInUnknownProtos
Type : DWORD
Nombre de paquets entrants qui ont été ignorés parce que le protocole était inconnu.
dwOutOctets
Type : DWORD
Nombre d’octets de données envoyées via cette interface.
dwOutUcastPkts
Type : DWORD
Nombre de paquets en unidiffusion envoyés via cette interface.
dwOutNUcastPkts
Type : DWORD
Nombre de paquets non unicast envoyés via cette interface. Les paquets de diffusion et de multidiffusion sont inclus.
dwOutDiscards
Type : DWORD
Nombre de paquets sortants qui ont été ignorés même s’ils n’avaient pas d’erreurs.
dwOutErrors
Type : DWORD
Nombre de paquets sortants qui ont été ignorés en raison d’erreurs.
dwOutQLen
Type : DWORD
Longueur de la file d’attente de transmission. Ce champ n’est pas utilisé actuellement.
dwDescrLen
Type : DWORD
Longueur, en octets, du membre bDescr .
bDescr[MAXLEN_IFDESCR]
Type : BYTE[MAXLEN_IFDESCR]
Description de l’interface.
Remarques
Le membre dwSpeed de la structure MIB_IFROW est incorrect pour les interfaces réseau à très haut débit (carte réseau de 10 Gbits/s, par exemple), car la valeur maximale pouvant être conservée dans un DWORD est 4 294 967 295. Les applications doivent utiliser la structure MIB_IF_ROW2 retournée par les fonctions GetIfEntry2 et GetIfTable2 ou la structure IP_ADAPTER_ADDRESSES retournée par la fonction GetAdaptersAddresses pour déterminer la vitesse des interfaces réseau à très haut débit.
Sur le Microsoft Kit de développement logiciel Windows (Kit SDK Windows) (SDK) publié pour Windows Vista et versions ultérieures, la organization des fichiers d’en-tête a changé et la structure MIB_IFROW est définie dans le fichier d’en-tête Ifmib.h et non dans le fichier d’en-tête Iprtrmib.h. Notez que le fichier d’en-tête Ifmib.h est automatiquement inclus dans Iprtrmib.h , qui est automatiquement inclus dans le fichier d’en-tête Iphlpapi.h . Les fichiers d’en-tête Ifmib.h et Iprtrmib.h ne doivent jamais être utilisés directement.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows 2000 Professionnel [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows 2000 Server [applications de bureau uniquement] |
| En-tête | ifmib.h (include Iphlpapi.h) |