NET_IF_INFORMATION structure (ndis.h)

Article
08/07/2023

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 d’interface (NET_IF_INFORMATION). Le fournisseur définit le membre Type de la structure que Header spécifie sur 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 avec 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 est destinée à un module de filtre.

NIIF_NDIS_RESERVED1

Réservé pour NDIS.

NIIF_NDIS_RESERVED2

Réservé pour NDIS.

NIIF_NDIS_RESERVED3

Réservé pour NDIS.

PhysicalLocation

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

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 pour l’interface.

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 .

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 en l’absence d’adaptateur physique.

PhysAddressLength

Longueur, en octets, de l’adresse physique ou de l’adresse MAC. Cette longueur est 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é sous la forme d’un 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 pour l’interface. Le fournisseur peut appeler la routine ExUuidCreate pour créer le GUID. Le GUID d’interface doit être associé à la valeur NET_LUID qui est affectée à l’interface. Si le fournisseur conserve des informations sur l’interface dans un 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 NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES structure .

MediaType

Type 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 NET_IF_INFORMATION pour fournir à NDIS des informations sur une interface inscrite. Pour inscrire une interface, un fournisseur passe un pointeur vers une structure de NET_IF_INFORMATION vers le Fonction NdisIfRegisterInterface .

Le fournisseur d’interface doit allouer suffisamment de mémoire pour la structure et les tableaux que les membres PhysAddressOffset, PermanentPhysAddressOffset et FriendlyNameOffset 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.