Lire en anglais

Partager via


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.

Valeur Signification
IF_TYPE_OTHER
1
Un autre type d’interface réseau.
IF_TYPE_ETHERNET_CSMACD
6
Une interface réseau Ethernet.
IF_TYPE_ISO88025_TOKENRING
9
Interface réseau en anneau de jeton.
IF_TYPE_FDDI
15
Une interface réseau FDDI (Fiber Distributed Data Interface).
IF_TYPE_PPP
23
Interface réseau PPP.
IF_TYPE_SOFTWARE_LOOPBACK
24
Interface réseau de bouclage logiciel.
IF_TYPE_ATM
37
Une interface réseau ATM.
IF_TYPE_IEEE80211
71
Interface réseau sans fil IEEE 802.11.
IF_TYPE_TUNNEL
131
Interface réseau d’encapsulation de type tunnel.
IF_TYPE_IEEE1394
144
Une interface réseau de bus série IEEE 1394 (Firewire) hautes performances.
IF_TYPE_IEEE80216_WMAN
237
Interface haut débit mobile pour les appareils WiMax.
Note Ce type d’interface est pris en charge sur Windows 7, Windows Server 2008 R2 et versions ultérieures.
 
IF_TYPE_WWANPP
243
Une interface haut débit mobile pour les appareils gsm.
Note Ce type d’interface est pris en charge sur Windows 7, Windows Server 2008 R2 et versions ultérieures.
 
IF_TYPE_WWANPP2
244
Une interface haut débit mobile pour les appareils CDMA.
Note Ce type d’interface est pris en charge sur Windows 7, Windows Server 2008 R2 et versions ultérieures.
 

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 .

Valeur Signification
IF_OPER_STATUS_NON_OPERATIONAL
L’adaptateur LAN a été désactivé, par exemple en raison d’un conflit d’adresse.
IF_OPER_STATUS_UNREACHABLE
Adaptateur WAN qui n’est pas connecté.
IF_OPER_STATUS_DISCONNECTED
Pour les cartes LAN : câble réseau déconnecté. Pour les adaptateurs WAN : aucun opérateur.
IF_OPER_STATUS_CONNECTING
Adaptateur WAN en cours de connexion.
IF_OPER_STATUS_CONNECTED
Adaptateur WAN connecté à un homologue distant.
IF_OPER_STATUS_OPERATIONAL
Status par défaut pour les adaptateurs LAN

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)

Voir aussi

GetAdaptersAddresses

GetIfEntry

GetIfEntry2

IP_ADAPTER_ADDRESSES

MIB_IFSTATUS

MIB_IFTABLE

MIB_IF_TABLE2

MPR_INTERFACE_0