NDIS_FILTER_ATTACH_PARAMETERS structure (ndis.h)
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.
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.
Configuration requise
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) |
Voir aussi
NDIS_MINIPORT_ADAPTER_NATIVE_802_11_ATTRIBUTES NDIS_RECEIVE_FILTER_CAPABILITIESCommentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour