Interrogation des paramètres d’un port virtuel

Un pilote qui se superpose peut obtenir les paramètres d’un port virtuel (VPort) sur un commutateur de carte réseau 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.

Avant que le pilote qui se superpose à cette demande de méthode OID, il doit initialiser une structure NDIS_NIC_SWITCH_VPORT_PARAMETERS . Le pilote doit définir les membres de cette structure de la manière suivante :

• Le membre SwitchId doit être défini sur l’identificateur du commutateur de carte réseau pour lequel les paramètres doivent être retournés.

  Note À compter de Windows Server 2012, l’interface SR-IOV ne prend en charge qu’un seul commutateur de carte réseau sur la carte réseau. Ce commutateur est appelé commutateur de carte réseau par défaut. Le membre SwitchId doit être défini sur NDIS_DEFAULT_SWITCH_ID.

• Le membre VPortId doit être défini 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 demande de méthode OID précédente de OID_NIC_SWITCH_CREATE_VPORT.

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

Après un retour réussi de cette 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 du VPort spécifié.

NDIS gère la demande de OID_NIC_SWITCH_VPORT_PARAMETERS pour les pilotes miniport. NDIS retourne les informations d’un cache interne des données qu’il gère à partir de l’inspection des sources suivantes :

• Demandes de méthode OID de OID_NIC_SWITCH_CREATE_VPORT.

• OID set requêtes de OID_NIC_SWITCH_VPORT_PARAMETERS.