NDIS_INTERFACE_INFORMATION structure (ifdef.h)

Article
08/24/2023

La structure NDIS_INTERFACE_INFORMATION fournit des informations sur une interface réseau pour l’OID OID_GEN_INTERFACE_INFO .

Syntaxe

typedef struct _NDIS_INTERFACE_INFORMATION {
  NET_IF_OPER_STATUS         ifOperStatus;
  ULONG                      ifOperStatusFlags;
  NET_IF_MEDIA_CONNECT_STATE MediaConnectState;
  NET_IF_MEDIA_DUPLEX_STATE  MediaDuplexState;
  ULONG                      ifMtu;
  BOOLEAN                    ifPromiscuousMode;
  BOOLEAN                    ifDeviceWakeUpEnable;
  ULONG64                    XmitLinkSpeed;
  ULONG64                    RcvLinkSpeed;
  ULONG64                    ifLastChange;
  ULONG64                    ifCounterDiscontinuityTime;
  ULONG64                    ifInUnknownProtos;
  ULONG64                    ifInDiscards;
  ULONG64                    ifInErrors;
  ULONG64                    ifHCInOctets;
  ULONG64                    ifHCInUcastPkts;
  ULONG64                    ifHCInMulticastPkts;
  ULONG64                    ifHCInBroadcastPkts;
  ULONG64                    ifHCOutOctets;
  ULONG64                    ifHCOutUcastPkts;
  ULONG64                    ifHCOutMulticastPkts;
  ULONG64                    ifHCOutBroadcastPkts;
  ULONG64                    ifOutErrors;
  ULONG64                    ifOutDiscards;
  ULONG64                    ifHCInUcastOctets;
  ULONG64                    ifHCInMulticastOctets;
  ULONG64                    ifHCInBroadcastOctets;
  ULONG64                    ifHCOutUcastOctets;
  ULONG64                    ifHCOutMulticastOctets;
  ULONG64                    ifHCOutBroadcastOctets;
  NET_IF_COMPARTMENT_ID      CompartmentId;
  ULONG                      SupportedStatistics;
} NDIS_INTERFACE_INFORMATION, *PNDIS_INTERFACE_INFORMATION;

Membres

ifOperStatus

Status opérationnelle de l’interface. Cette status est identique à la valeur retournée par l’OID OID_GEN_OPERATIONAL_STATUS.

ifOperStatusFlags

Indicateurs de status opérationnels de l’interface. Ce champ est réservé au fournisseur d’interface proxy NDIS. Les autres fournisseurs d’interface doivent définir ce membre sur zéro.

MediaConnectState

Type d’état de connexion NET_IF_MEDIA_CONNECT_STATE .

MediaDuplexState

État duplex multimédia de l’interface. Cet état est identique à la valeur retournée par l’OID OID_GEN_MEDIA_DUPLEX_STATE .

ifMtu

Unité de transmission maximale (MTU) de l’interface. Cette MTU est identique à la valeur retournée par l’OID OID_GEN_MAXIMUM_FRAME_SIZE .

ifPromiscuousMode

Valeur booléenne true si l’interface est en mode promiscuous ou FALSE si ce n’est pas le cas. Cette valeur est identique à la valeur que OID_GEN_PROMISCUOUS_MODE requête OID retourne.

ifDeviceWakeUpEnable

Valeur booléenne true si l’interface prend en charge la fonctionnalité wake-on-LAN et que la fonctionnalité est activée, ou FALSE si ce n’est pas le cas.

XmitLinkSpeed

Vitesse de la liaison de transmission, en octets par seconde, de l’interface. Cette vitesse est identique à la valeur retournée par une requête OID OID_GEN_XMIT_LINK_SPEED .

RcvLinkSpeed

Vitesse de la liaison de réception, en octets par seconde, de l’interface. Cette vitesse est identique à la valeur qu’une requête OID OID_GEN_RCV_LINK_SPEED retourne.

ifLastChange

Heure à laquelle l’interface est entrée dans son état opérationnel actuel. Cette durée est identique à la valeur retournée par une requête OID OID_GEN_LAST_CHANGE .

ifCounterDiscontinuityTime

Heure de la dernière discontinuité des compteurs de l’interface. Cette durée est identique à la valeur qu’une requête OID OID_GEN_DISCONTINUITY_TIME retourne.

ifInUnknownProtos

Nombre de paquets qui ont été reçus via l’interface et qui ont été ignorés en raison d’un protocole inconnu ou non pris en charge. Ce nombre est identique à la valeur retournée par une requête OID OID_GEN_UNKNOWN_PROTOS .

ifInDiscards

Nombre de paquets entrants qui ont été ignorés même si aucune erreur n’a été détectée pour les empêcher d’être livrables dans un protocole de couche supérieure. Ce nombre est identique à la valeur qu’une requête OID OID_GEN_RCV_DISCARDS retourne.

ifInErrors

Nombre de paquets entrants qui contenaient des erreurs qui les empêchaient d’être livrables dans un protocole de couche supérieure. Ce nombre est identique à la valeur qu’une requête OID OID_GEN_RCV_ERROR retourne.

ifHCInOctets

Nombre total d’octets reçus sur cette interface. Ce nombre est identique à la valeur qu’un OID OID_GEN_BYTES_RCV retourne.

ifHCInUcastPkts

Nombre de paquets dirigés qui sont reçus sans erreurs sur l’interface. Ce nombre est identique à la valeur retournée par une requête OID OID_GEN_DIRECTED_FRAMES_RCV .

ifHCInMulticastPkts

Nombre de paquets de multidiffusion/fonctionnels reçus sans erreur sur l’interface. Ce nombre est identique à la valeur qu’une requête OID OID_GEN_MULTICAST_FRAMES_RCV retourne.

ifHCInBroadcastPkts

Nombre de paquets de diffusion reçus sans erreur sur l’interface. Ce nombre est identique à la valeur qu’une requête OID OID_GEN_BROADCAST_FRAMES_RCV retourne.

ifHCOutOctets

Nombre d’octets transmis sans erreur sur l’interface. Ce nombre est identique à la valeur qu’une requête OID OID_GEN_BYTES_XMIT retourne.

ifHCOutUcastPkts

Nombre de paquets dirigés transmis sans erreur sur l’interface. Ce nombre est identique à la valeur qu’une requête OID OID_GEN_DIRECTED_FRAMES_XMIT retourne.

ifHCOutMulticastPkts

Nombre de paquets de multidiffusion/fonctionnels transmis sans erreur sur l’interface. Ce nombre est identique à la valeur qu’une requête OID OID_GEN_MULTICAST_FRAMES_XMIT retourne.

ifHCOutBroadcastPkts

Nombre de paquets de diffusion transmis sans erreur sur l’interface. Ce nombre est identique à la valeur qu’une requête OID OID_GEN_BROADCAST_FRAMES_XMIT retourne.

ifOutErrors

Nombre de paquets que l’interface ne parvient pas à transmettre. Ce nombre est identique à la valeur qu’une requête OID OID_GEN_XMIT_ERROR retourne.

ifOutDiscards

Nombre de paquets ignorés par l’interface. Ce nombre est identique à la valeur qu’une requête OID OID_GEN_XMIT_DISCARDS retourne.

ifHCInUcastOctets

Nombre d’octets dans les paquets dirigés qui sont reçus sans erreurs. Ce nombre est la même valeur que celle que OID_GEN_DIRECTED_BYTES_RCV retourne.

ifHCInMulticastOctets

Nombre d’octets dans les paquets de multidiffusion/fonctionnels qui sont reçus sans erreurs. Ce nombre est la même valeur que celle que OID_GEN_MULTICAST_BYTES_RCV retourne.

ifHCInBroadcastOctets

Nombre d’octets dans les paquets de diffusion qui sont reçus sans erreurs. Ce nombre est la même valeur que celle que OID_GEN_BROADCAST_BYTES_RCV retourne.

ifHCOutUcastOctets

Nombre d’octets dans les paquets dirigés transmis sans erreur. Ce nombre est la même valeur que celle que OID_GEN_DIRECTED_BYTES_XMIT retourne.

ifHCOutMulticastOctets

Nombre d’octets dans les paquets de multidiffusion/fonctionnels transmis sans erreur. Ce nombre est la même valeur que celle que OID_GEN_MULTICAST_BYTES_XMIT retourne.

ifHCOutBroadcastOctets

Nombre d’octets dans les paquets de diffusion transmis sans erreur. Ce nombre est la même valeur que celle que OID_GEN_BROADCAST_BYTES_XMIT retourne.

CompartmentId

Compartiment auquel appartient l’interface, si le fournisseur d’interface peut fournir l’ID du compartiment auquel appartient l’interface. Sinon, elle doit retourner NET_IF_COMPARTMENT_ID_UNSPECIFIED. Si le fournisseur d’interface retourne NET_IF_COMPARTMENT_ID_UNSPECIFIED pour l’ID de compartiment, NDIS retourne l’ID de compartiment approprié pour cette interface.

SupportedStatistics

Statistiques prises en charge. Pour plus d’informations, consultez le membre SupportedStatistics de la structure NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES .

Remarques

Les fournisseurs d’interface NDIS remplissent une structure NDIS_INTERFACE_INFORMATION en réponse à une requête de l’OID OID_GEN_INTERFACE_INFO . Cette structure contient des informations qui changent pendant la durée de vie de l’interface.

Pour s’inscrire en tant que fournisseur d’interface, un pilote NDIS appelle la fonction NdisIfRegisterProvider .