Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Un pilote surlysant émet une demande de méthode d’identificateur d’objet (OID) de OID_NIC_SWITCH_PARAMETERS pour obtenir les paramètres de configuration actuels d’un commutateur de carte réseau spécifié sur une carte réseau. NDIS gère ces demandes de méthode OID pour le pilote miniport.
Le surlysage des pilotes émet une demande de jeu OID de OID_NIC_SWITCH_PARAMETERS pour définir les paramètres de configuration d’un commutateur de carte réseau spécifié sur une carte réseau. Ces demandes de jeu OID sont émises au pilote miniport de la fonction physique PCI Express (PCIe) de la carte réseau. Ces demandes de jeu d’OID sont requises pour les pilotes miniport PF qui prennent en charge l’interface de virtualisation d’E/S racine unique (SR-IOV).
Le membre InformationBuffer de la structure NDIS_OID_REQUEST contient un pointeur vers une structure NDIS_NIC_SWITCH_PARAMETERS.
Le pilote overlying spécifie le commutateur de carte réseau pour la méthode OID ou la requête définie en définissant le SwitchId membre de la structure NDIS_NIC_SWITCH_PARAMETERS sur l’identificateur de commutateur. Le pilote surlysant obtient l’identificateur de commutateur de l’une des manières suivantes :
À partir d’une requête de méthode OID précédente de OID_NIC_SWITCH_ENUM_SWITCHES.
À partir du membre NicSwitchArray de la structure NDIS_BIND_PARAMETERS. NDIS transmet un pointeur vers cette structure dans le paramètre BindParameters de la fonction ProtocolBindAdapterEx.
À partir du membre NicSwitchArray de la structure NDIS_FILTER_ATTACH_PARAMETERS. NDIS transmet un pointeur à cette structure dans le paramètre AttachParameters de la fonction FilterAttach.
Remarque à partir de Windows Server 2012, Windows prend uniquement en charge le commutateur de carte réseau par défaut sur la carte réseau. Le SwitchId membre de la structure NDIS_NIC_SWITCH_PARAMETERS doit être défini sur NDIS_DEFAULT_SWITCH_ID.
Remarques
Les problèmes de pilote excessive OID_NIC_SWITCH_PARAMETERS demandes de la manière suivante :
Le pilote surlysant émet une demande de méthode OID de OID_NIC_SWITCH_PARAMETERS pour obtenir les paramètres actuels d’un commutateur de carte réseau spécifié. Pour plus d’informations, consultez interrogation des paramètres d’un commutateur de carte réseau.
Remarque NDIS gère les requêtes de méthode OID de OID_NIC_SWITCH_PARAMETERS pour le pilote miniport PF.
Le pilote surlysant émet une demande d’ensemble OID de OID_NIC_SWITCH_PARAMETERS pour modifier les paramètres actuels d’un commutateur de carte réseau spécifié. Pour plus d’informations, consultez Définition des paramètres d’un commutateur de carte réseau.
Remarque Le pilote miniport PF gère les requêtes définies par OID de OID_NIC_SWITCH_PARAMETERS.
Codes d’état de retour
NDIS ou le pilote miniport PF retourne les codes d’état suivants pour les requêtes OID définies ou de méthode de OID_NIC_SWITCH_PARAMETERS.
| Code d’état | Description |
|---|---|
NDIS_STATUS_SUCCESS |
La demande s’est terminée avec succès. Le InformationBuffer pointe vers une structure NDIS_NIC_SWITCH_CAPABILITIES. |
NDIS_STATUS_NOT_SUPPORTED |
Le pilote pf miniport ne prend pas en charge l’interface d’E/S racine unique (SR-IOV) ou n’est pas activé pour utiliser l’interface. |
NDIS_STATUS_INVALID_PARAMETER |
Une ou plusieurs des membres de la structure NDIS_NIC_SWITCH_PARAMETERS ont des valeurs non valides. |
NDIS_STATUS_INVALID_LENGTH |
La mémoire tampon d’informations était trop courte. NDIS ou le pilote pf miniport définit la DATA. METHOD_INFORMATION. BytesNeededed membre (pour les requêtes de méthode OID) ou DATA. SET_INFORMATION. BytesNeededed membre (pour les requêtes définies par OID) dans la structure NDIS_OID_REQUEST à la taille de mémoire tampon minimale requise. |
NDIS_STATUS_REINIT_REQUIRED |
Le pilote pf miniport nécessite une réinitialisation de la carte réseau pour appliquer les modifications au commutateur de carte réseau. |
NDIS_STATUS_FAILURE |
La demande a échoué pour d’autres raisons. |
Exigences
Version |
Prise en charge dans NDIS 6.30 et versions ultérieures. |
En-tête |
Ntddndis.h (include Ndis.h) |