OID_NIC_SWITCH_PARAMETERS

Article
06/15/2023

Un pilote qui se superpose é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.

Les pilotes overlying émettent 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 d’ensemble OID sont envoyées au pilote miniport de la fonction physique (PF) PCI Express (PCIe) de la carte réseau. Ces demandes de jeu d’OID sont requises pour les pilotes pf miniport 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 demande de définition en définissant le membre SwitchId de la structure NDIS_NIC_SWITCH_PARAMETERS sur l’identificateur du commutateur. Le pilote qui se superpose obtient l’identificateur de commutateur de l’une des manières suivantes :

À partir d’une demande 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 vers cette structure dans le paramètre AttachParameters de la fonction FilterAttach .

Note À compter de Windows Server 2012, Windows prend uniquement en charge le commutateur de carte réseau par défaut sur la carte réseau. Le membre SwitchId de la structure NDIS_NIC_SWITCH_PARAMETERS doit être défini sur NDIS_DEFAULT_SWITCH_ID.

Notes

Le pilote qui se superpose OID_NIC_SWITCH_PARAMETERS les requêtes de la manière suivante :

Le pilote qui se superpose é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.

Note NDIS gère les demandes de méthode OID de OID_NIC_SWITCH_PARAMETERS pour le pilote pf miniport.
Le pilote qui se superpose é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.

Note Le pilote pf miniport gère les demandes de jeu OID de OID_NIC_SWITCH_PARAMETERS.

Codes d’état de retour

NDIS ou le pilote pf miniport retourne les codes status suivants pour les requêtes OID de jeu 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. InformationBuffer pointe vers une structure NDIS_NIC_SWITCH_CAPABILITIES.
NDIS_STATUS_NOT_SUPPORTED	Le pilote pf miniport ne prend pas en charge l’interface de virtualisation d’E/S racine unique (SR-IOV) ou n’est pas activé pour utiliser l’interface.
NDIS_STATUS_INVALID_PARAMETER	Un 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 les DONNÉES. METHOD_INFORMATION. Membre BytesNeeded (pour les demandes de méthode OID) ou DATA. SET_INFORMATION. BytesNeeded member (pour les demandes de jeu d’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.