OID_NIC_SWITCH_ENUM_VFS

Article
03/13/2025

Un pilote ou une application en mode utilisateur excessive émet une demande de méthode d’identificateur d’objet (OID) de OID_NIC_SWITCH_ENUM_VFS pour obtenir un tableau. Chaque élément du tableau spécifie les attributs d’une fonction virtuelle PCI Express (PCIe) attachée à un commutateur de carte réseau sur le commutateur de carte réseau.

Après un retour réussi de cette requête OID, le InformationBuffer membre de la structure NDIS_OID_REQUEST contient un pointeur vers une mémoire tampon qui contient les éléments suivants :

Structure NDIS_NIC_SWITCH_VF_INFO_ARRAY qui définit le nombre d’éléments dans le tableau.
Tableau de structures NDIS_NIC_SWITCH_VF_INFO. Chacune de ces structures contient des informations sur une seule machine virtuelle sur un commutateur de carte réseau de la carte réseau. Une machine virtuelle est attachée à un commutateur de carte réseau via des requêtes de méthode OID de OID_NIC_SWITCH_ALLOCATE_VF.

Remarque Si aucune machine virtuelle n’est attachée à un commutateur de carte réseau sur la carte réseau, les NombreElements membre de la structure NDIS_NIC_SWITCH_VF_INFO_ARRAY sont définis sur zéro et aucune structure NDIS_NIC_SWITCH_VF_INFO n’est retournée.

Remarques

Le dépassement des pilotes et des applications en mode utilisateur émet des demandes de méthode OID de OID_NIC_SWITCH_ENUM_VFS pour énumérer les machines virtuelles attachées au commutateur de carte réseau d’une carte réseau.

Avant que le pilote ou l’application émet la requête OID, elle doit initialiser une structure de NDIS_NIC_SWITCH_VF_INFO_ARRAY transmise avec la requête. Le pilote ou l’application doit suivre ces instructions lors de l’initialisation de la structure NDIS_NIC_SWITCH_VF_INFO_ARRAY :

Si l’indicateur NDIS_NIC_SWITCH_VF_INFO_ARRAY_ENUM_ON_SPECIFIC_SWITCH est défini dans le membre Indicateurs, le pilote ou l’application doit définir le SwitchId membre sur l’identificateur de commutateur de carte réseau sur la carte réseau SR-IOV. En définissant ces membres de cette façon, les informations VF sont retournées uniquement pour le commutateur de carte réseau spécifiée sur la carte réseau SR-IOV.

Remarque L’application de pilote et de mode utilisateur excessive peut obtenir les identificateurs de commutateur de carte réseau en émettant une requête de requête OID de OID_NIC_SWITCH_ENUM_SWITCHES.
Si les indicateurs membre ont la valeur zéro, le pilote ou l’application doit définir le SwitchId membre sur zéro. En définissant ces membres de cette façon, les informations VF sont retournées pour tous les commutateurs de carte réseau sur la carte réseau SR-IOV.

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. Quels que soient les indicateurs définis dans le membre des indicateurs de, le switchId membre doit être défini sur NDIS_DEFAULT_SWITCH_ID.

Pour plus d’informations sur les commutateurs de carte réseau, consultez commutateurs de carte réseau.

Codes d’état de retour

NDIS gère la requête de méthode OID de la demande de OID_NIC_SWITCH_ENUM_VFS pour les pilotes miniport. Les pilotes ne seront pas émis cette demande OID.

Lorsque NDIS gère la requête OID_NIC_SWITCH_ENUM_VFS, elle retourne l’un des codes d’état suivants.

Code d’état	Description
NDIS_STATUS_SUCCESS	La requête OID s’est terminée avec succès.
NDIS_STATUS_NOT_SUPPORTED	Le pilote 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	Un ou plusieurs des membres de la structure NDIS_NIC_SWITCH_VF_INFO_ARRAY ont des valeurs non valides.
NDIS_STATUS_INVALID_LENGTH	La mémoire tampon d’informations était trop courte. NDIS définit le DATA. METHOD_INFORMATION. OctetsNeeded membre de la structure NDIS_OID_REQUEST à la taille de mémoire tampon minimale requise.
NDIS_STATUS_FAILURE	La demande a échoué pour d’autres raisons.