NET_IF_INFORMATION structure (ndis.h)
La structure NET_IF_INFORMATION fournit à NDIS des informations sur une interface réseau inscrite.
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;
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 :
Définissez si l’interface réseau est destinée au matériel.
Définissez si l’interface réseau est destinée à un module de filtre.
Réservé pour NDIS.
Réservé pour NDIS.
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
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.
Condition requise | Valeur |
---|---|
Client minimal pris en charge | Pris en charge dans NDIS 6.0 et versions ultérieures. |
En-tête | ndis.h (inclure Ndis.h) |