MIB_IF_ROW2 structure
La structure MIB_IF_ROW2 stocke des informations sur une interface particulière.
Syntaxe
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;
Membres
InterfaceLuid
Identificateur local unique (LUID) pour l’interface réseau.InterfaceIndex
Index qui identifie l’interface réseau. 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.InterfaceGuid
GUID de l’interface réseau.Alias
Chaîne Unicode terminée par null qui contient le nom d’alias de l’interface réseau.Description
Chaîne Unicode terminée par null qui contient une description de l’interface réseau.PhysicalAddressLength
Longueur, en octets, de l’adresse matérielle physique spécifiée par le membre PhysicalAddress.PhysicalAddress
Adresse matérielle physique de l’adaptateur pour cette interface réseau.PermanentPhysicalAddress
Adresse matérielle physique permanente de l’adaptateur pour cette interface réseau.Mtu
Taille maximale de l’unité de transmission (MTU), en octets, pour cette interface réseau.Type
Type d’interface tel que défini par l’IANA (Internet Assigned Names Authority). Pour plus d’informations, consultez DÉFINITIONS 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 suivant 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 d’anneau de jeton
IF_TYPE_PPP
23
Une 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
Une interface réseau sans fil IEEE 802.11
IF_TYPE_TUNNEL
131
Interface réseau d’encapsulation de type tunnel
IF_TYPE_IEEE1394
144
Interface réseau de bus série haute performance IEEE 1394 (Firewire)
TunnelType
Si le membre Type est IF_TYPE_TUNNEL, un type TUNNEL_TYPE qui définit la méthode d’encapsulation utilisée par un tunnel.MediaType
Type de média NDIS pour l’interface. Ce membre peut être l’une des valeurs suivantes du type d’énumération NDIS_MEDIUM défini dans le fichier d’en-tête Ntddndis.h.Valeur Signification NdisMedium802_3
0
Un réseau Ethernet (802.3).
NdisMedium802_5
1
Un réseau Token Ring (802.5).
NdisMediumFddi
2
Un réseau FDDI (Fiber Distributed Data Interface).
NdisMediumWan
3
Un réseau étendu (WAN). Ce type couvre différentes formes de cartes réseau point à point et WAN, ainsi que des formats d’adresse/d’en-tête de variante qui doivent être négociés entre le pilote de protocole et le pilote sous-jacent une fois la liaison établie.
NdisMediumLocalTalk
4
Un réseau LocalTalk.
NdisMediumDix
5
Réseau Ethernet pour lequel les pilotes utilisent le format d’en-tête Ethernet DIX.
NdisMediumArcnetRaw
6
Un réseau ARCNET.
NdisMediumArcnet878_2
7
Un réseau ARCNET (878.2).
NdisMediumAtm
8
Un réseau ATM. Les pilotes de protocole client orientés connexion peuvent se lier à un pilote miniport sous-jacent qui retourne cette valeur. Sinon, les pilotes de protocole hérités se lient eux-mêmes au pilote intermédiaire LanE fourni par le système, qui signale son type moyen comme NdisMedium802_3 ou NdisMedium802_5, selon la façon dont l’administrateur réseau configure le pilote LanE.
NdisMediumWirelessWan
9
Un réseau sans fil. NDIS 5. x les pilotes miniports qui prennent en charge les paquets LAN (WLAN) ou WAN sans fil (WWAN) déclarent leur support comme NdisMedium802_3 et émulent Ethernet vers des pilotes NDIS de niveau supérieur.
Remarque Ce type de média n’est pas disponible pour une utilisation sur Windows Vista ou les versions ultérieures de Windows.
NdisMediumIrda
10
Réseau infrarouge (IrDA).
NdisMediumBpc
11
Un réseau d’ordinateurs de diffusion.
NdisMediumCoWan
12
Réseau étendu dans un environnement orienté connexion.
NdisMedium1394
13
Un réseau IEEE 1394 (fil d’incendie).
NdisMediumInfiniBand
14
Réseau InfiniBand.
NdisMediumTunnel
15
Réseau de tunnel.
NdisMediumNative802_11
16
Un réseau IEEE 802.11 natif.
NdisMediumLoopback
17
Un réseau de bouclage NDIS.
PhysicalMediumType
Type de support physique NDIS. Ce membre peut être l’une des valeurs suivantes du type d’énumération NDIS_PHYSICAL_MEDIUM défini dans le fichier d’en-tête Ntddndis.h.Valeur Signification NdisPhysicalMediumUnspecified
0
Le support physique n’est pas les valeurs suivantes. Par exemple, un flux satellite unidirectionnel est un support physique non spécifié.
NdisPhysicalMediumWirelessLan
1
Les paquets sont transférés sur un réseau LAN sans fil via un pilote miniport conforme à l’interface 802.11.
NdisPhysicalMediumCableModem
2
Les paquets sont transférés sur un réseau câblé DOCSIS.
NdisPhysicalMediumPhoneLine
3
Les paquets sont transférés sur les lignes téléphoniques standard. Ce type inclut le média HomePNA.
NdisPhysicalMediumPowerLine
4
Les paquets sont transférés via le câblage connecté à un système de distribution d’alimentation.
NdisPhysicalMediumDSL
5
Les paquets sont transférés sur un réseau DSL (Digital Subscriber Line). Ce type inclut ADSL, UADSL (G.Lite) et SDSL.
NdisPhysicalMediumFibreChannel
6
Les paquets sont transférés via une interconnexion Fibre Channel.
NdisPhysicalMedium1394
7
Les paquets sont transférés sur un bus IEEE 1394.
NdisPhysicalMediumWirelessWan
8
Les paquets sont transférés via une liaison WAN sans fil. Ce type inclut CDPD, CDMA et GPRS.
NdisPhysicalMediumNative802_11
9
Les paquets sont transférés sur un réseau LAN sans fil via un pilote miniport conforme à l’interface Native 802.11.
Remarque L’interface Native 802.11 est prise en charge dans NDIS 6.0 et versions ultérieures.
NdisPhysicalMediumBluetooth
10
Les paquets sont transférés sur un réseau Bluetooth. Bluetooth est une technologie sans fil à courte portée qui utilise le spectre de 2,4 GHz.
NdisPhysicalMediumInfiniband
11
Les paquets sont transférés via une interconnexion InfiniBand.
NdisPhysicalMediumUWB
13
Les paquets sont transférés sur un réseau ultra large bande.
NdisPhysicalMedium802_3
14
Les paquets sont transférés sur un réseau Ethernet (802.3).
NdisPhysicalMedium802_5
15
Les paquets sont transférés sur un réseau Token Ring (802.5).
NdisPhysicalMediumIrda
16
Les paquets sont transférés sur un réseau infrarouge (IrDA).
NdisPhysicalMediumWiredWAN
17
Les paquets sont transférés sur un réseau WAN câblé.
NdisPhysicalMediumWiredCoWan
18
Les paquets sont transférés sur un réseau étendu dans un environnement orienté connexion.
NdisPhysicalMediumOther
19
Les paquets sont transférés sur un réseau qui n’est pas décrit par d’autres valeurs possibles.
AccessType
Type d’accès à l’interface réseau NDIS NET_IF_ACCESS_TYPE.DirectionType
Type de direction d’interface réseau NDIS NET_IF_DIRECTION_TYPE .InterfaceAndOperStatusFlags
Ensemble des indicateurs suivants qui fournissent des informations sur l’interface. Ces indicateurs sont combinés à une opération OR au niveau du bit. Si aucun des indicateurs ne s’applique, ce membre est défini sur zéro.HardwareInterface
L’interface réseau est destinée au matériel.FilterInterface
L’interface réseau correspond à un module de filtre.ConnectorPresent
Un connecteur est présent sur l’interface réseau. Cette valeur est définie s’il existe une carte réseau physique.Non authentifié
Le port par défaut de l’interface réseau n’est pas authentifié. Si une interface réseau n’est pas authentifiée par la cible, l’interface réseau n’est pas en mode opérationnel. Bien que cette situation s’applique aux connexions réseau câblées et sans fil, l’authentification est plus courante pour les connexions réseau sans fil.NotMediaConnected
L’interface réseau n’est pas dans un état connecté au média. Si un câble réseau est débranché pour un réseau câblé, cette valeur est définie. Pour un réseau sans fil, cette valeur est définie pour la carte réseau qui n’est pas connectée à un réseau.En pause
La pile réseau de l’interface réseau est à l’état suspendu ou en pause. Cette valeur ne signifie pas que l’ordinateur est dans un état hibernated.LowPower
L’interface réseau est à faible consommation d’énergie.EndPointInterface
L’interface réseau est un appareil de point de terminaison et non une véritable interface réseau qui se connecte à un réseau. Cette valeur peut être définie par des appareils, tels que des smartphones, qui utilisent l’infrastructure réseau pour communiquer avec l’ordinateur, mais qui ne fournissent pas de connectivité à un réseau externe. Ces types d’appareils doivent définir cet indicateur.
OperStatus
Type de status opérationnel d’interface réseau NDIS IF_OPER_STATUS.AdminStatus
Type de status administratif NET_IF_ADMIN_STATUS.MediaConnectState
Type d’état de connexion NET_IF_MEDIA_CONNECT_STATE .NetworkGuid
GUID associé au réseau auquel appartient l’interface.ConnectionType
Type de connexion d’interface réseau NDIS NET_IF_CONNECTION_TYPE.TransmitLinkSpeed
Vitesse, en bits par seconde, du lien de transmission.ReceiveLinkSpeed
Vitesse, en bits par seconde, du lien de réception.InOctets
Nombre d’octets de données reçus sans erreurs via cette interface. Cette valeur inclut les octets dans les paquets unicast, broadcast et multidiffusion.InUcastPkts
Nombre de paquets unicast reçus sans erreurs via cette interface.InNUcastPkts
Nombre de paquets non unicast reçus sans erreur via cette interface. Cette valeur inclut les paquets de diffusion et de multidiffusion.InDiscards
Nombre de paquets entrants qui ont été ignorés même s’ils n’avaient pas d’erreurs.InErrors
Nombre de paquets entrants qui ont été ignorés en raison d’erreurs.InUnknownProtos
Nombre de paquets entrants qui ont été ignorés parce que le protocole était inconnu.InUcastOctets
Nombre d’octets de données reçus sans erreurs dans les paquets unicast via cette interface.InMulticastOctets
Nombre d’octets de données reçus sans erreurs dans les paquets de multidiffusion via cette interface.InBroadcastOctets
Nombre d’octets de données reçues sans erreurs dans les paquets de diffusion via cette interface.OutOctets
Nombre d’octets de données qui sont transmis sans erreur via cette interface. Cette valeur inclut les octets dans les paquets unicast, broadcast et multidiffusion.OutUcastPkts
Nombre de paquets unicast transmis sans erreurs via cette interface.OutNUcastPkts
Nombre de paquets non unicast qui sont transmis sans erreur via cette interface. Cette valeur inclut les paquets de diffusion et de multidiffusion.OutDiscards
Nombre de paquets sortants qui ont été ignorés même s’ils n’avaient pas d’erreurs.OutErrors
Nombre de paquets sortants qui ont été ignorés en raison d’erreurs.OutUcastOctets
Nombre d’octets de données transmis sans erreurs dans les paquets unicast via cette interface.OutMulticastOctets
Nombre d’octets de données qui sont transmis sans erreurs dans les paquets de multidiffusion via cette interface.OutBroadcastOctets
Nombre d’octets de données qui sont transmis sans erreurs dans les paquets de diffusion via cette interface.OutQLen
Longueur de la file d’attente de transmission. Ce champ n’est pas utilisé actuellement.
Notes
Les valeurs du champ Type sont définies dans le fichier d’en-tête Ipifcons.h. Seules les valeurs possibles répertoriées dans la description du membre Type sont actuellement prises en charge.
Spécifications
Version |
Disponible dans Windows Vista et les versions ultérieures des systèmes d’exploitation Windows. |
En-tête |
Netioapi.h (inclure Netioapi.h) |