NDIS_FILTER_ATTACH_PARAMETERS structure (ndis.h)

Article
08/07/2023

La structure NDIS_FILTER_ATTACH_PARAMETERS définit les paramètres d’initialisation pour le module de filtre.

Syntaxe

typedef struct _NDIS_FILTER_ATTACH_PARAMETERS {
  NDIS_OBJECT_HEADER                Header;
  NET_IFINDEX                       IfIndex;
  NET_LUID                          NetLuid;
  PNDIS_STRING                      FilterModuleGuidName;
  NET_IFINDEX                       BaseMiniportIfIndex;
  PNDIS_STRING                      BaseMiniportInstanceName;
  PNDIS_STRING                      BaseMiniportName;
  NDIS_MEDIA_CONNECT_STATE          MediaConnectState;
  NET_IF_MEDIA_DUPLEX_STATE         MediaDuplexState;
  ULONG64                           XmitLinkSpeed;
  ULONG64                           RcvLinkSpeed;
  NDIS_MEDIUM                       MiniportMediaType;
  NDIS_PHYSICAL_MEDIUM              MiniportPhysicalMediaType;
  NDIS_HANDLE                       MiniportMediaSpecificAttributes;
  PNDIS_OFFLOAD                     DefaultOffloadConfiguration;
  USHORT                            MacAddressLength;
  UCHAR                             CurrentMacAddress[NDIS_MAX_PHYS_ADDRESS_LENGTH];
  NET_LUID                          BaseMiniportNetLuid;
  NET_IFINDEX                       LowerIfIndex;
  NET_LUID                          LowerIfNetLuid;
  ULONG                             Flags;
  PNDIS_HD_SPLIT_CURRENT_CONFIG     HDSplitCurrentConfig;
  PNDIS_RECEIVE_FILTER_CAPABILITIES ReceiveFilterCapabilities;
  PDEVICE_OBJECT                    MiniportPhysicalDeviceObject;
  PNDIS_NIC_SWITCH_CAPABILITIES     NicSwitchCapabilities;
  BOOLEAN                           BaseMiniportIfConnectorPresent;
  PNDIS_SRIOV_CAPABILITIES          SriovCapabilities;
  PNDIS_NIC_SWITCH_INFO_ARRAY       NicSwitchArray;
} NDIS_FILTER_ATTACH_PARAMETERS, *PNDIS_FILTER_ATTACH_PARAMETERS;

Membres

Header

Structure NDIS_OBJECT_HEADER de la structure NDIS_FILTER_ATTACH_PARAMETERS . NDIS définit le membre Type de la structure spécifiée par Header sur NDIS_OBJECT_TYPE_FILTER_ATTACH_PARAMETERS.

Pour indiquer la version de la structure NDIS_FILTER_ATTACH_PARAMETERS , NDIS définit le membre Revision sur l’une des valeurs suivantes :

NDIS_FILTER_ATTACH__PARAMETERS_REVISION_4

Ajout de différents membres pour NDIS 6.30.

NDIS définit le membre Size sur NDIS_SIZEOF_FILTER_ATTACH_PARAMETERS_REVISION_4.

NDIS_FILTER_ATTACH_PARAMETERS_REVISION_3

Ajout des membres ReceiveFilterCapabilities, MiniportPhysicalDeviceObject et NicSwitchCapabilities pour NDIS 6.20.

NDIS définit le membre Size sur NDIS_SIZEOF_FILTER_ATTACH_PARAMETERS_REVISION_3.

NDIS_FILTER_ATTACH_PARAMETERS_REVISION_2

Ajout du membre HDSplitCurrentConfig pour NDIS 6.1.

NDIS définit le membre Size sur NDIS_SIZEOF_FILTER_ATTACH_PARAMETERS_REVISION_2.

NDIS_FILTER_ATTACH_PARAMETERS_REVISION_1

Version d’origine de NDIS 6.0.

NDIS définit le membre Size sur NDIS_SIZEOF_FILTER_ATTACH_PARAMETERS_REVISION_1.

IfIndex

Index d’interface NDIS du module de filtre que NDIS attache à la pile de pilotes.

NetLuid

L’interface réseau NDIS NET_LUID valeur pour le module de filtre que NDIS attache à la pile de pilotes. Le NET_LUID équivaut au nom de l’interface (ifName dans RFC 2863 ).

FilterModuleGuidName

Nom GUID du module de filtre joint par NDIS.

BaseMiniportIfIndex

Index d’interface réseau NDIS de l’adaptateur miniport de base. Autrement dit, s’il existe des miniports virtuels ou des modules de filtre installés sur un adaptateur de miniport physique, la valeur de ce membre est l’index d’interface de l’adaptateur de miniport physique ou un miniport virtuel du pilote intermédiaire MUX de niveau le plus élevé.

BaseMiniportInstanceName

Pointeur vers une valeur de type NDIS_STRING qui contient une chaîne Unicode comptée. Cette chaîne spécifie le nom convivial de l’interface de l’adaptateur miniport de base. Pour Windows 2000 et versions ultérieures, NDIS définit le type NDIS_STRING en tant que type UNICODE_STRING .

BaseMiniportName

Nom de l’adaptateur miniport de base.

MediaConnectState

The NET_IF_MEDIA_CONNECT_STATE type d’état de connexion.

MediaDuplexState

État duplex multimédia de l’adaptateur miniport sous-jacent. Pour plus d’informations, consultez OID_GEN_MEDIA_DUPLEX_STATE.

XmitLinkSpeed

Vitesse de liaison de transmission actuelle de l’adaptateur miniport sous-jacent en bits par seconde. Pour plus d’informations, consultez OID_GEN_LINK_SPEED_EX.

RcvLinkSpeed

Vitesse de liaison de réception actuelle de l’adaptateur miniport sous-jacent en bits par seconde. Pour plus d’informations, consultez OID_GEN_LINK_SPEED_EX.

MiniportMediaType

Type NdisMediumXxx pris en charge par l’adaptateur miniport sous-jacent de base. Pour plus d’informations, consultez NDIS_MEDIUM.

MiniportPhysicalMediaType

Type de support physique de l’adaptateur miniport sous-jacent de base. Pour plus d’informations, consultez OID_GEN_PHYSICAL_MEDIUM.

MiniportMediaSpecificAttributes

Pointeur vers une structure NDIS_OBJECT_HEADER qui identifie une structure qui contient des attributs spécifiques au média miniport, ou NULL s’il n’existe aucun attribut de ce type. Le membre Type de la structure NDIS_OBJECT_HEADER identifie le type de la structure d’attributs. Par exemple, si le type de média de l’adaptateur miniport sous-jacent est NdisMediumNative802_11, le membre Type doit être NDIS_OBJECT_TYPE_MINIPORT_ADAPTER_NATIVE_802_11_ATTRIBUTES et le membre MiniportMediaSpecificAttributes pointe vers un NDIS_MINIPORT_ADAPTER_NATIVE_802_11_ATTRIBUTES structure.

DefaultOffloadConfiguration

Pointeur vers une structure NDIS_OFFLOAD qui définit les attributs de déchargement de tâche. Le pilote de filtre doit passer en revue ces attributs pour obtenir les fonctionnalités de déchargement des tâches des pilotes sous-jacents. Le pilote de filtre doit modifier ces attributs, si nécessaire, pour refléter les modifications apportées à la prise en charge du déchargement des tâches dont il a besoin.

MacAddressLength

Longueur de l’adresse MAC, en octets. La longueur de l’adresse MAC est spécifique au type de média.

CurrentMacAddress[NDIS_MAX_PHYS_ADDRESS_LENGTH]

Adresse MAC actuelle. Par exemple, l’OID OID_802_3_CURRENT_ADDRESS spécifie l’adresse MAC actuelle pour les pilotes IEEE 802.3.

BaseMiniportNetLuid

L’interface réseau NDIS NET_LUID de l’adaptateur miniport de base. Autrement dit, s’il existe des miniports virtuels ou des modules de filtre installés sur un adaptateur de miniport physique, la valeur de ce membre est la NET_LUID de l’adaptateur de miniport physique ou d’un miniport virtuel du pilote intermédiaire MUX de niveau le plus élevé.

LowerIfIndex

Index d’interface réseau NDIS de l’interface juste en dessous du module de filtre actuel. Autrement dit, s’il existe des modules de filtre ou NDIS 5. X pilotes intermédiaires de filtre installés sur un adaptateur miniport physique ou le pilote intermédiaire MUX de niveau le plus élevé, ce membre contient l’index d’interface de l’interface du module de filtre ou de l’interface de pilote intermédiaire de filtre qui se trouve juste en dessous du module de filtre actuel. Si aucun module de filtre ou aucune interface de pilote intermédiaire de filtre n’est installée sur l’adaptateur miniport physique ou le pilote intermédiaire MUX de niveau supérieur, ce membre contient l’index d’interface de l’adaptateur miniport physique sous-jacent ou du miniport virtuel du pilote intermédiaire MUX de niveau le plus élevé.

LowerIfNetLuid

L’interface réseau NDIS NET_LUID valeur de l’interface juste en dessous du module de filtre actuel. Autrement dit, s’il existe des modules de filtre ou NDIS 5. X pilotes intermédiaires de filtre installés sur un adaptateur miniport physique ou le pilote intermédiaire MUX de niveau le plus élevé, ce membre contient l’interface réseau NET_LUID de l’interface de module de filtre ou de l’interface de pilote intermédiaire de filtre qui se trouve juste en dessous du module de filtre actuel. S’il n’y a pas d’interfaces de module de filtre ou de pilote intermédiaire de filtre installées sur l’adaptateur miniport physique ou le pilote intermédiaire MUX de niveau supérieur, ce membre contient l’interface réseau NET_LUID de l’adaptateur miniport physique sous-jacent ou du miniport virtuel du pilote intermédiaire MUX de niveau le plus élevé.

Flags

Réservé pour un usage futur.

HDSplitCurrentConfig

Pointeur vers un NDIS_HD_SPLIT_CURRENT_CONFIG structure. Cette structure spécifie la configuration actuelle du fractionnement d’en-tête et de données de l’adaptateur miniport sous-jacent. Cette valeur peut être NULL si l’adaptateur miniport ne prend pas en charge le fractionnement d’en-tête-données.

ReceiveFilterCapabilities

Pointeur vers un NDIS_RECEIVE_FILTER_CAPABILITIES structure. Cette structure spécifie les fonctionnalités de filtrage générique actuellement activées sur l’adaptateur miniport sous-jacent. Cette valeur peut être NULL si l’adaptateur miniport ne prend pas en charge le filtrage de réception.

MiniportPhysicalDeviceObject

Pointeur vers une structure DEVICE_OBJECT . Cette structure représente l’appareil physique de l’adaptateur miniport sous-jacent.

NicSwitchCapabilities

Pointeur vers un NDIS_NIC_SWITCH_CAPABILITIES structure. Cette structure spécifie les fonctionnalités de commutateur de carte réseau de l’adaptateur miniport sous-jacent. Cette valeur peut être NULL si l’adaptateur miniport ne prend pas en charge les fonctionnalités de commutateur de carte réseau.

BaseMiniportIfConnectorPresent

Valeur booléenne qui, si elle est définie sur TRUE, indique si un connecteur d’interface réseau (si) est présent sur la carte réseau sous-jacente. Cette valeur doit être définie sur TRUE pour une carte physique.

SriovCapabilities

Pointeur vers une structure NDIS_SRIOV_CAPABILITIES . Cette structure spécifie les fonctionnalités de virtualisation d’E/S racine unique (SR-IOV) qui sont actuellement activées sur l’adaptateur miniport sous-jacent. Cette valeur peut être NULL si l’adaptateur miniport ne prend pas en charge les fonctionnalités SR-IOV.

Pour plus d’informations, consultez Virtualisation d’E/S racine unique (SR-IOV).

NicSwitchArray

Pointeur vers une structure NDIS_NIC_SWITCH_INFO_ARRAY . Ce tableau énumère les commutateurs de carte réseau qui ont été créés sur l’adaptateur miniport. Les commutateurs de carte réseau peuvent être créés uniquement si SR-IOV est pris en charge et activé sur l’adaptateur.

Note À compter de Windows Server 2012, Windows prend uniquement en charge le commutateur de carte réseau par défaut créé sur l’adaptateur miniport de fonction physique (PF). Par conséquent, ce tableau ne peut contenir qu’un seul élément.

Remarques

Pour définir des paramètres d’attachement de module de filtre, NDIS transmet un pointeur vers une structure NDIS_FILTER_ATTACH_PARAMETERS à la fonction FilterAttach .

Les pilotes de filtre doivent éviter d’émettre des requêtes OID inutiles. Utilisez plutôt les informations dans NDIS_FILTER_ATTACH_PARAMETERS, lorsqu’elles sont disponibles, pour obtenir des informations sur les pilotes sous-jacents.