structure NDIS_BIND_PARAMETERS (ndis.h)

Article
03/01/2024

NDIS initialise une structure de NDIS_BIND_PARAMETERS avec des informations qui définissent les caractéristiques d’une liaison et les passent à un pilote de protocole.

Syntaxe

typedef struct _NDIS_BIND_PARAMETERS {
  NDIS_OBJECT_HEADER                Header;
  PNDIS_STRING                      ProtocolSection;
  PNDIS_STRING                      AdapterName;
  PDEVICE_OBJECT                    PhysicalDeviceObject;
  NDIS_MEDIUM                       MediaType;
  ULONG                             MtuSize;
  ULONG64                           MaxXmitLinkSpeed;
  ULONG64                           XmitLinkSpeed;
  ULONG64                           MaxRcvLinkSpeed;
  ULONG64                           RcvLinkSpeed;
  NDIS_MEDIA_CONNECT_STATE          MediaConnectState;
  NDIS_MEDIA_DUPLEX_STATE           MediaDuplexState;
  ULONG                             LookaheadSize;
  PNDIS_PNP_CAPABILITIES            PowerManagementCapabilities;
  ULONG                             SupportedPacketFilters;
  ULONG                             MaxMulticastListSize;
  USHORT                            MacAddressLength;
  UCHAR                             CurrentMacAddress[NDIS_MAX_PHYS_ADDRESS_LENGTH];
  NDIS_PHYSICAL_MEDIUM              PhysicalMediumType;
  PNDIS_RECEIVE_SCALE_CAPABILITIES  RcvScaleCapabilities;
  NET_LUID                          BoundIfNetluid;
  NET_IFINDEX                       BoundIfIndex;
  NET_LUID                          LowestIfNetluid;
  NET_IFINDEX                       LowestIfIndex;
  NET_IF_ACCESS_TYPE                AccessType;
  NET_IF_DIRECTION_TYPE             DirectionType;
  NET_IF_CONNECTION_TYPE            ConnectionType;
  NET_IFTYPE                        IfType;
  BOOLEAN                           IfConnectorPresent;
  PNDIS_PORT                        ActivePorts;
  ULONG                             DataBackFillSize;
  ULONG                             ContextBackFillSize;
  ULONG                             MacOptions;
  NET_IF_COMPARTMENT_ID             CompartmentId;
  PNDIS_OFFLOAD                     DefaultOffloadConfiguration;
  PNDIS_TCP_CONNECTION_OFFLOAD      TcpConnectionOffloadCapabilities;
  PNDIS_STRING                      BoundAdapterName;
  PNDIS_HD_SPLIT_CURRENT_CONFIG     HDSplitCurrentConfig;
  PNDIS_RECEIVE_FILTER_CAPABILITIES ReceiveFilterCapabilities;
  PNDIS_PM_CAPABILITIES             PowerManagementCapabilitiesEx;
  PNDIS_NIC_SWITCH_CAPABILITIES     NicSwitchCapabilities;
  BOOLEAN                           NDKEnabled;
  PNDIS_NDK_CAPABILITIES            NDKCapabilities;
  PNDIS_SRIOV_CAPABILITIES          SriovCapabilities;
  PNDIS_NIC_SWITCH_INFO_ARRAY       NicSwitchArray;
} NDIS_BIND_PARAMETERS, *PNDIS_BIND_PARAMETERS;

Membres

Header

Structure NDIS_OBJECT_HEADER de la structure NDIS_BIND_PARAMETERS . NDIS définit le membre Type de la structure que l’en-tête spécifie sur NDIS_OBJECT_TYPE_BIND_PARAMETERS.

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

NDIS_BIND_PARAMETERS_REVISION_4

Ajout de différents membres pour NDIS 6.30.

NDIS définit le membre Size sur NDIS_SIZEOF_BIND_PARAMETERS_REVISION_4.

NDIS_BIND_PARAMETERS_REVISION_3

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

NDIS définit le membre Size sur NDIS_SIZEOF_BIND_PARAMETERS_REVISION_3.

NDIS_BIND_PARAMETERS_REVISION_2

Ajout du membre HDSplitCurrentConfig pour NDIS 6.1.

NDIS définit le membre Size sur NDIS_SIZEOF_BIND_PARAMETERS_REVISION_2.

NDIS_BIND_PARAMETERS_REVISION_1

Version d’origine pour NDIS 6.0.

NDIS définit le membre Size sur NDIS_SIZEOF_BIND_PARAMETERS_REVISION_1.

ProtocolSection

Pointeur vers une chaîne Unicode qui contient un chemin d’accès au Registre. Le chemin commence à partir de la clé de service du pilote de protocole et continue dans la hiérarchie du Registre jusqu’au nom de l’adaptateur miniport (par exemple, Tcpip\Parameters\Adapters\nom >de l’adaptateur< miniport). Le nom de l’adaptateur miniport est le nom de l’adaptateur miniport le plus bas dans la pile des pilotes. S’il existe un pilote intermédiaire MUX dans la pile, l’adaptateur miniport le plus bas est un miniport virtuel. Sinon, l’adaptateur miniport le plus bas est un adaptateur miniport pour un appareil physique.

Le pilote de protocole peut utiliser ce chemin d’accès au Registre pour lire les paramètres de configuration spécifiques à la liaison entre le pilote et l’adaptateur miniport sous-jacent.

AdapterName

Pointeur vers une chaîne Unicode qui contient le nom de l’adaptateur miniport sous-jacent auquel ProtocolBindAdapterEx doit être lié.

PhysicalDeviceObject

Objet d’appareil physique pour l’adaptateur miniport sous-jacent.

MediaType

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

MtuSize

Taille maximale de l’unité de transfert (MTU). Pour plus d’informations, consultez OID_GEN_MAXIMUM_FRAME_SIZE.

MaxXmitLinkSpeed

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

XmitLinkSpeed

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

MaxRcvLinkSpeed

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

RcvLinkSpeed

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

MediaConnectState

État de connexion multimédia de l’adaptateur miniport sous-jacent. Pour plus d'informations, consultez la rubrique OID_GEN_MEDIA_CONNECT_STATUS_EX.

MediaDuplexState

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

LookaheadSize

Taille du lookahead de l’adaptateur miniport sous-jacent. Pour plus d’informations, consultez OID_GEN_CURRENT_LOOKAHEAD.

PowerManagementCapabilities

Fonctionnalités Plug-and-Play de l’adaptateur miniport sous-jacent. Pour plus d’informations, consultez OID_PNP_CAPABILITIES. Les pilotes NDIS 6.20 et versions ultérieures doivent utiliser le membre PowerManagementCapabilitiesEx à la place.

SupportedPacketFilters

Ensemble d’indicateurs qui identifient les types de paquets réseau que l’adaptateur miniport sous-jacent peut filtrer.

MaxMulticastListSize

Taille de la liste d’adresses de multidiffusion pour l’adaptateur miniport sous-jacent. Pour plus d'informations, consultez la rubrique OID_802_3_MAXIMUM_LIST_SIZE.

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.

PhysicalMediumType

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

RcvScaleCapabilities

Fonctionnalités de mise à l’échelle côté réception (RSS) de la carte réseau. Pour plus d'informations, consultez la rubrique OID_GEN_RECEIVE_SCALE_CAPABILITIES.

BoundIfNetluid

La valeur NDIS NET_LUID , qui est également le nom de l’interface réseau ( ifName dans RFC 2863), de l’interface de niveau supérieur empilée sur la carte miniport. Autrement dit, s’il existe des miniports virtuels ou des modules de filtre installés sur l’adaptateur miniport, il s’agit de la valeur NET_LUID du module de filtre ou de miniport virtuel de niveau le plus élevé.

BoundIfIndex

Index d’interface réseau NDIS de l’interface de niveau supérieur empilée sur la carte miniport. Autrement dit, s’il existe des miniports virtuels ou des modules de filtre installés sur l’adaptateur miniport, il s’agit de l’ifIndex du module de filtre ou miniport virtuel le plus haut niveau.

LowestIfNetluid

NDIS NET_LUID valeur, qui est également le nom de l’interface réseau ( ifName dans RFC 2863), de l’interface de niveau le plus bas sur une liaison. Autrement dit, l’interface réseau NDIS de l’adaptateur miniport au bas d’une pile de filtres.

LowestIfIndex

Index d’interface réseau NDIS de l’interface de niveau le plus bas sur une liaison. Autrement dit, l’interface réseau NDIS de l’adaptateur miniport au bas d’une pile de filtres.

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. Utilisez NET_IF_CONNECTION_DEDICATED pour un adaptateur Ethernet classique. Les valuse suivantes sont valides :

NET_IF_CONNECTION_DEDICATED

Spécifie le type de connexion dédié. La connexion s’affiche automatiquement lorsque l’sens multimédia a la valeur TRUE. Par exemple, une connexion Ethernet est dédiée.

NET_IF_CONNECTION_PASSIVE

Spécifie le type de connexion passive. L’autre extrémité doit faire remonter la connexion à la station locale. Par exemple, l’interface RAS est passive.

NET_IF_CONNECTION_DEMAND

Spécifie le type de connexion à la numérotation à la demande. Une connexion de numérotation à la demande apparaît en réponse à une action locale, par exemple, en envoyant un paquet.

IfType

Type d’interface IANA (Internet Assigned Numbers Authority). Par exemple, IF_TYPE_ETHERNET_CSMACD (6) est la valeur de IfType affectée à n’importe quelle interface de type Ethernet. Pour obtenir la liste des types d’interface, consultez Types d’interface NDIS.

IfConnectorPresent

Valeur booléenne qui indique si un connecteur est présent. NDIS définit cette valeur sur TRUE s’il existe une carte physique.

ActivePorts

À déterminer.

DataBackFillSize

Taille de remplissage des données requise, en octets, de la pile de pilotes sous-jacente.

ContextBackFillSize

Taille de remplissage de contexte requise, en octets, de la pile de pilotes sous-jacente.

MacOptions

Options MAC pour l’adaptateur miniport. Pour plus d’informations, consultez OID_GEN_MAC_OPTIONS.

CompartmentId

Compartiment auquel appartient l’interface sous-jacente ou l’une des valeurs suivantes :

NET_IF_COMPARTMENT_ID_UNSPECIFIED

Spécifie que l’identificateur de compartiment n’est pas utilisé ou spécifié.

NET_IF_COMPARTMENT_ID_PRIMARY

Spécifie l’identificateur de compartiment par défaut. Les fournisseurs d’interface tiers doivent toujours spécifier NET_IF_COMPARTMENT_ID_PRIMARY. Toutes les autres valeurs sont réservées à une utilisation interne de Microsoft.

DefaultOffloadConfiguration

Pointeur vers une structure NDIS_OFFLOAD . Cette structure spécifie les fonctionnalités d’un adaptateur miniport prenant en charge les tâches de déchargement. Pour plus d'informations, consultez la rubrique OID_TCP_OFFLOAD_CURRENT_CONFIG.

TcpConnectionOffloadCapabilities

Pointeur vers un NDIS_TCP_CONNECTION_OFFLOAD structure qui indique les fonctionnalités de déchargement actuelles fournies par l’adaptateur miniport sous-jacent.

BoundAdapterName

Pointeur vers une chaîne Unicode qui contient le nom de l’adaptateur miniport de niveau le plus élevé qui est empilé sur l’adaptateur miniport sous-jacent. Autrement dit, s’il existe des miniports virtuels de pilote intermédiaires de filtre qui sont installés sur l’adaptateur miniport, ce membre est le nom du miniport virtuel du pilote intermédiaire de filtre de niveau le plus élevé.

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.

PowerManagementCapabilitiesEx

Pointeur vers une structure NDIS_PM_CAPABILITIES . Cette structure spécifie les fonctionnalités de gestion de l’alimentation de l’adaptateur miniport. Ce membre est obligatoire pour les pilotes NDIS 6.20 et ultérieur.

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.

NDKEnabled

NDIS définit cette valeur sur TRUE si l’interface du fournisseur de noyau direct réseau (NDKPI) est actuellement activée sur l’adaptateur miniport sous-jacent.

NDKCapabilities

Pointeur vers une structure NDIS_NDK_CAPABILITIES . Cette structure spécifie les fonctionnalités NDKPI actuellement activées sur l’adaptateur miniport sous-jacent. Cette valeur peut être NULL si l’adaptateur miniport ne prend pas en charge NDKPI.

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.

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 ne peuvent être créés que 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 sur l’adaptateur miniport. Par conséquent, ce tableau ne peut contenir qu’un seul élément.