OID_NIC_SWITCH_VPORT_PARAMETERS

Article
06/15/2023

Un pilote de dépassement peut obtenir les paramètres d’un port virtuel (VPort) sur un commutateur de carte réseau qui a été créé sur une carte réseau qui prend en charge la virtualisation d’E/S racine unique (SR-IOV). Le pilote émet une demande de méthode d’identificateur d’objet (OID) de OID_NIC_SWITCH_VPORT_PARAMETERS pour obtenir ces paramètres.

Les pilotes sur-ment émettent une demande de jeu d’OID de OID_NIC_SWITCH_VPORT_PARAMETERS pour définir les paramètres de configuration d’un VPort spécifié qui est attaché au commutateur de carte réseau de la carte réseau. Ces demandes de jeu d’OID sont émises 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_VPORT_PARAMETERS .

Le pilote overlying spécifie le VPort pour la méthode OID ou la demande de définition en définissant le membre VPortId de la structure NDIS_NIC_SWITCH_VPORT_PARAMETERS sur l’identificateur associé au VPort. Le pilote qui se superpose obtient l’identificateur VPort de l’une des manières suivantes :

À partir d’une précédente demande de méthode OID de OID_NIC_SWITCH_CREATE_VPORT.
À partir d’une précédente demande de méthode OID de OID_NIC_SWITCH_ENUM_VPORTS.

Notes

OID_NIC_SWITCH_VPORT_PARAMETERS peuvent être utilisés dans les requêtes de méthode OID ou dans les requêtes de jeu d’OID.

Gestion des requêtes de méthode OID de OID_NIC_SWITCH_VPORT_PARAMETERS

Les pilotes excessivement émettent une demande de méthode OID de OID_NIC_SWITCH_VPORT_PARAMETERS pour interroger les paramètres de configuration actuels d’un VPort attaché au commutateur de carte réseau de la carte réseau. Les pilotes excessivement spécifient le VPort à interroger en définissant le membre VPortId de la structure NDIS_NIC_SWITCH_VPORT_PARAMETERS sur l’identificateur VPort.

NDIS gère la demande de méthode OID de OID_NIC_SWITCH_VPORT_PARAMETERS pour les pilotes miniport. NDIS retourne les informations qu’il a obtenues à partir de requêtes OID précédentes de OID_NIC_SWITCH_CREATE_VPORT et de OID_NIC_SWITCH_ENUM_VPORTS.

Après un retour réussi de la demande de méthode OID, le membre InformationBuffer de la structure NDIS_OID_REQUEST contient un pointeur vers une structure NDIS_NIC_SWITCH_VPORT_PARAMETERS . Cette structure contient les paramètres de configuration du commutateur spécifié.

Pour plus d’informations, consultez Interrogation des paramètres d’un port virtuel.

Gestion des demandes d’ensemble d’OID de OID_NIC_SWITCH_VPORT_PARAMETERS

Les pilotes sur-ment émettent une demande de jeu d’OID de OID_NIC_SWITCH_VPORT_PARAMETERS pour modifier les paramètres de configuration actuels d’un VPort attaché au commutateur de carte réseau d’une carte réseau. Cette requête OID peut être utilisée pour mettre à jour les paramètres pour les VPorts par défaut et non par défaut.

Seul un sous-ensemble limité de paramètres de configuration pour un VPort peut être modifié. Le pilote overlying spécifie le paramètre à modifier en définissant les membres suivants de la structure NDIS_NIC_SWITCH_VPORT_PARAMETERS :

Le membre VPortId est défini sur l’identificateur du VPort dont les paramètres seront modifiés.
Les indicateurs NDIS_NIC_SWITCH_VPORT_PARAMETERS_Xxx_CHANGED appropriés sont définis dans le membre Indicateurs . Les membres de la structure NDIS_NIC_SWITCH_VPORT_PARAMETERS ne peuvent être modifiés que si un indicateur NDIS_NIC_SWITCH_PARAMETERS_Xxx_CHANGED correspondant est défini dans Ntddndis.h.
Les membres correspondants de la structure NDIS_NIC_SWITCH_VPORT_PARAMETERS sont définis avec les paramètres de configuration VPort qui doivent être modifiés.

Une fois que le pilote pf miniport a reçu la demande de jeu d’OID de OID_NIC_SWITCH_VPORT_PARAMETERS, le pilote configure le matériel avec les paramètres de configuration. Le pilote peut uniquement modifier les paramètres de configuration identifiés par les indicateurs NDIS_NIC_SWITCH_VPORT_PARAMETERS_Xxx_CHANGED dans le membre Flags de la structure NDIS_NIC_SWITCH_VPORT_PARAMETERS .

Pour plus d’informations, consultez Définition des paramètres d’un port virtuel.

Codes d’état de retour

NDIS ou le pilote pf miniport retourne le code status suivant pour les requêtes OID set ou method de OID_NIC_SWITCH_VPORT_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_VPORT_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. Le membre BytesNeeded (pour les demandes de jeu d’OID) dans la structure NDIS_OID_REQUEST à la taille de mémoire tampon minimale requise.
NDIS_STATUS_FAILURE	La demande a échoué pour d’autres raisons.