Partager via


OID_NIC_SWITCH_ENUM_VFS

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 (VF) PCI Express (PCIe) attachée à un commutateur de carte réseau sur le commutateur de carte réseau d’une carte réseau.

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

Notes

Les pilotes et les applications en mode utilisateur excessives émettent des demandes de méthode OID de OID_NIC_SWITCH_ENUM_VFS d’é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 n’émet la requête OID, elle doit initialiser une structure NDIS_NIC_SWITCH_VF_INFO_ARRAY qui est transmise avec la demande. 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 Flags , le pilote ou l’application doit définir le membre SwitchId sur l’identificateur du 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é sur la carte réseau SR-IOV.

    Note Le pilote trop élevé et l’application en mode utilisateur peuvent obtenir les identificateurs de commutateur de carte réseau en émettant une requête OID de OID_NIC_SWITCH_ENUM_SWITCHES.

  • Si le membre Flags est défini sur zéro, le pilote ou l’application doit définir le membre SwitchId 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.

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. Quels que soient les indicateurs définis dans le membre Flags , le membre SwitchId 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 demande 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, il retourne l’un des codes status suivants.

Code d’état Description

NDIS_STATUS_SUCCESS

La demande OID s’est terminée avec succès.

NDIS_STATUS_NOT_SUPPORTED

Le pilote 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_VF_INFO_ARRAY ont des valeurs non valides.

NDIS_STATUS_INVALID_LENGTH

La mémoire tampon d’informations était trop courte. NDIS définit les DONNÉES. METHOD_INFORMATION. BytesNeeded membre 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.

Spécifications

Version

Pris en charge dans NDIS 6.30 et versions ultérieures.

En-tête

Ntddndis.h (inclure Ndis.h)

Voir aussi


NDIS_NIC_SWITCH_VF_INFO

NDIS_NIC_SWITCH_VF_INFO_ARRAY

NDIS_OID_REQUEST

OID_NIC_SWITCH_ALLOCATE_VF

OID_NIC_SWITCH_CREATE_SWITCH

OID_NIC_SWITCH_VF_PARAMETERS