structure NDIS_BIND_PARAMETERS (ndis.h)
NDIS initialise une structure NDIS_BIND_PARAMETERS avec des informations qui définissent les caractéristiques d’une liaison et la transmet à 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 pour la structure NDIS_BIND_PARAMETERS. NDIS définit le membre type de la structure qui Header spécifie la valeur NDIS_OBJECT_TYPE_BIND_PARAMETERS.
Pour indiquer la version de la structure NDIS_BIND_PARAMETERS, NDIS définit le membre révision 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 taille sur NDIS_SIZEOF_BIND_PARAMETERS_REVISION_4.
NDIS_BIND_PARAMETERS_REVISION_3
Ajout du ReceiveFilterCapabilities, PowerManagementCapabilitiesExet membres NicSwitchCapabilities pour NDIS 6.20.
NDIS définit le membre taille 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 taille sur NDIS_SIZEOF_BIND_PARAMETERS_REVISION_2.
NDIS_BIND_PARAMETERS_REVISION_1
Version d’origine de 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 passe de la hiérarchie du Registre 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 de 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 devez lier.
PhysicalDeviceObject
Objet d’appareil physique pour l’adaptateur miniport sous-jacent.
MediaType
Le 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 maximale de transmission 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 maximale de réception 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 pour l’adaptateur miniport sous-jacent. Pour plus d’informations, consultez 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 de lookahead pour 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 ultérieurs doivent utiliser le membre PowerManagementCapabilitiesEx à la place.
SupportedPacketFilters
Ensemble d’indicateurs qui identifient les types de paquets réseau que la carte miniport sous-jacente peut filtrer.
MaxMulticastListSize
Taille de la liste d’adresses de multidiffusion pour l’adaptateur miniport sous-jacent. Pour plus d’informations, consultez 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 pour l’adaptateur miniport. Pour plus d’informations, consultez OID_GEN_PHYSICAL_MEDIUM.
RcvScaleCapabilities
Les fonctionnalités de mise à l’échelle côté réception (RSS) de la carte réseau. Pour plus d’informations, consultez OID_GEN_RECEIVE_SCALE_CAPABILITIES.
BoundIfNetluid
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 miniport virtuel ou du module de filtre virtuel de niveau le plus élevé.
BoundIfIndex
Index d’interface réseau NDIS de l’interface de niveau le plus élevé empilé 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 miniport virtuel ou du module de filtre virtuel de niveau le plus élevé.
LowestIfNetluid
Valeur NET_LUID NDIS, 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 la carte 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 la carte miniport au bas d’une pile de filtres.
AccessType
Type d’accès de l’interface réseau NDIS NET_IF_ACCESS_TYPE.
DirectionType
Type de direction de l’interface réseau NDIS NET_IF_DIRECTION_TYPE.
ConnectionType
Type de connexion de l’interface réseau NDIS. Utilisez NET_IF_CONNECTION_DEDICATED pour un adaptateur Ethernet classique. Les valeurs suivantes sont valides :
NET_IF_CONNECTION_DEDICATED
Spécifie le type de connexion dédié. La connexion s’affiche automatiquement lorsque le sens multimédia est TRUE. Par exemple, une connexion Ethernet est dédiée.
NET_IF_CONNECTION_PASSIVE
Spécifie le type de connexion passif. L’autre extrémité doit afficher la connexion à la station locale. Par exemple, l’interface RAS est passive.
NET_IF_CONNECTION_DEMAND
Spécifie le type de connexion à numérotation à la demande. Une connexion à numérotation à la demande s’affiche 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é à n’importe quelle interface de type Ethernet. Pour obtenir une liste si les 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 un adaptateur 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 l’interface sous-jacente appartient 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 à l’utilisation interne de Microsoft.
DefaultOffloadConfiguration
Pointeur vers une structure NDIS_OFFLOAD. Cette structure spécifie les fonctionnalités d’un adaptateur miniport compatible avec les tâches. Pour plus d’informations, consultez 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 supérieur empilé sur l’adaptateur miniport sous-jacent. Autrement dit, s’il existe des miniports virtuels de pilote intermédiaire de filtre installés sur l’adaptateur miniport, ce membre est le nom du miniport virtuel du pilote intermédiaire de filtre de niveau supérieur.
HDSplitCurrentConfig
Pointeur vers un structure NDIS_HD_SPLIT_CURRENT_CONFIG. Cette structure spécifie la configuration actuelle de fractionnement des données d’en-tête de l’adaptateur miniport sous-jacent. Cette valeur peut être NULL si l’adaptateur miniport ne prend pas en charge le fractionnement des données d’en-tête.
ReceiveFilterCapabilities
Pointeur vers un structure NDIS_RECEIVE_FILTER_CAPABILITIES. 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érieurs.
NicSwitchCapabilities
Pointeur vers un structure NDIS_NIC_SWITCH_CAPABILITIES. 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 la carte miniport sous-jacente.
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 (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.
Remarques
NDIS transmet un pointeur à une structure de NDIS_BIND_PARAMETERS dans le paramètre BindParameters du Fonction ProtocolBindAdapterEx.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Prise en charge dans NDIS 6.0 et versions ultérieures. |
| d’en-tête | ndis.h (include Ndis.h) |
Voir aussi
NDIS_RECEIVE_FILTER_CAPABILITIESOID_GEN_MEDIA_CONNECT_STATUS_EX
OID_GEN_RECEIVE_SCALE_CAPABILITIES