structure NET_IF_INFORMATION (ndis.h)

Article
02/07/2025

La structure NET_IF_INFORMATION fournit à NDIS des informations sur une interface réseau inscrite.

Syntaxe

typedef struct _NET_IF_INFORMATION {
  NDIS_OBJECT_HEADER     Header;
  ULONG                  Flags;
  NET_PHYSICAL_LOCATION  PhysicalLocation;
  ULONG                  WanTunnelType;
  ULONG                  PortNumber;
  NET_IF_ACCESS_TYPE     AccessType;
  NET_IF_DIRECTION_TYPE  DirectionType;
  NET_IF_CONNECTION_TYPE ConnectionType;
  BOOLEAN                ifConnectorPresent;
  USHORT                 PhysAddressLength;
  USHORT                 PhysAddressOffset;
  USHORT                 PermanentPhysAddressOffset;
  USHORT                 FriendlyNameLength;
  USHORT                 FriendlyNameOffset;
  GUID                   InterfaceGuid;
  NET_IF_NETWORK_GUID    NetworkGuid;
  ULONG                  SupportedStatistics;
  NDIS_MEDIUM            MediaType;
  NDIS_PHYSICAL_MEDIUM   PhysicalMediumType;
} NET_IF_INFORMATION, *PNET_IF_INFORMATION;

Membres

Header

Structure NDIS_OBJECT_HEADER pour la structure d’informations de l’interface (NET_IF_INFORMATION). Le fournisseur définit le membre type de la structure spécifiée par Header à NDIS_OBJECT_TYPE_DEFAULT, le membre Revision sur NDIS_OBJECT_REVISION_1 et le membre Size sur NDIS_SIZEOF_NET_IF_INFORMATION_REVISION_1.

Flags

Indicateurs qui fournissent des informations sur l’interface décrite par cette structure. Ces indicateurs sont combinés à une opération OR au niveau du bit. Si aucun des indicateurs ne s’applique, définissez ce membre sur zéro. Les valeurs d’indicateur suivantes sont définies :

NIIF_HARDWARE_INTERFACE

Définissez si l’interface réseau est destinée au matériel.

NIIF_FILTER_INTERFACE

Définissez si l’interface réseau concerne un module de filtre.

NIIF_NDIS_RESERVED1

Réservé à NDIS.

NIIF_NDIS_RESERVED2

Réservé à NDIS.

NIIF_NDIS_RESERVED3

Réservé à NDIS.

PhysicalLocation

Emplacement physique du matériel associé à une interface spécifiée dans un structure NET_PHYSICAL_LOCATION.

WanTunnelType

TunnelIfEncapsMethod (à partir de RFC 2667) pour les appareils WAN. Si le type de tunnel WAN est inconnu, définissez ce membre sur NIIF_WAN_TUNNEL_TYPE_UNKNOWN.

PortNumber

Numéro de port NDIS de l’interface.

AccessType

Type d’accès de l’interface réseau NDIS NET_IF_ACCESS_TYPE.

DirectionType

Type de direction de l’interface réseau NDIS NET_IF_DIRECTION_TYPE.

ConnectionType

Type de connexion d’interface réseau NDIS NET_IF_CONNECTION_TYPE.

ifConnectorPresent

Valeur booléenne qui indique si un connecteur est présent. Définissez cette valeur sur TRUE s’il existe une carte physique ou FALSE s’il n’y a pas d’adaptateur physique.

PhysAddressLength

Longueur, en octets, de l’adresse physique ou de l’adresse MAC. Cette longueur correspond à la longueur des tableaux d’octets situés aux décalages spécifiés par les membres physAddressOffset et PermanentPhysAddressOffset.

PhysAddressOffset

Décalage de l’adresse physique actuelle, en octets, à partir du début de cette structure. L’adresse physique actuelle est un tableau d’octets. La longueur du tableau est spécifiée dans le membre PhysAddressLength. L’adresse physique actuelle est la même valeur que celle retournée par l’OID OID_802_3_CURRENT_ADDRESS.

PermanentPhysAddressOffset

Décalage de l’adresse physique permanente, en octets, à partir du début de cette structure. L’adresse physique permanente est un tableau d’octets. La longueur du tableau est spécifiée dans le membre PhysAddressLength. L’adresse physique permanente est la même valeur que celle retournée par l’OID OID_802_3_PERMANENT_ADDRESS.

FriendlyNameLength

Longueur, en octets, du nom convivial de l’interface décrite par cette structure. Cette longueur est la longueur du tableau WCHAR qui se trouve au décalage dans le membre FriendlyNameOffset.

FriendlyNameOffset

Décalage du début du nom convivial, en octets, à partir du début de cette structure. Ce nom doit inclure le nom du fabricant, du produit et de la version du matériel et du logiciel d’interface. Le nom est spécifié en tant que tableau de valeurs WCHAR. Le membre FriendlyNameLength spécifie la longueur du tableau.

InterfaceGuid

GUID associé à l’interface. Le fournisseur d’interface génère le GUID d’interface de l’interface. Le fournisseur peut appeler la routine ExUuidCreate pour créer le GUID. Le GUID de l’interface doit être associé à la valeur NET_LUID affectée à l’interface. Si le fournisseur conserve des informations sur l’interface dans le stockage persistant, il doit enregistrer le GUID et réutiliser le GUID lorsqu’il réinscrit l’interface après le redémarrage de l’ordinateur.

NetworkGuid

GUID associé au réseau auquel appartient l’interface. Si le fournisseur d’interface ne peut pas fournir le GUID réseau, il peut passer un GUID zéro. Dans ce cas, NDIS inscrit l’interface dans le réseau par défaut du compartiment principal.

SupportedStatistics

Statistiques que l’interface prend en charge. Pour plus d’informations, consultez le membre SupportedStatistics du structure NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES .

MediaType

Type de NdisMediumXxx pris en charge par l’interface. Pour plus d’informations, consultez NDIS_MEDIUM.

PhysicalMediumType

Type de support physique pour l’interface. Pour plus d’informations, consultez OID_GEN_PHYSICAL_MEDIUM

Remarques

Un fournisseur d’interface réseau initialise une structure de NET_IF_INFORMATION pour fournir à NDIS des informations sur une interface inscrite. Pour inscrire une interface, un fournisseur transmet un pointeur à une structure NET_IF_INFORMATION à la fonction NdisIfRegisterInterface.

Le fournisseur d’interface doit allouer suffisamment de mémoire pour la structure et les tableaux que les PhysAddressOffset, PermanentPhysAddressOffsetet FriendlyNameOffset membres spécifient. Le fournisseur doit fournir les valeurs des tableaux après la structure et définir les membres de décalage pour identifier l’emplacement des tableaux.