OID_NIC_SWITCH_ENUM_VPORTS
Un pilote trop élevé ou une application en mode utilisateur émet une demande de méthode d’identificateur d’objet (OID) de OID_NIC_SWITCH_ENUM_VPORTS pour obtenir un tableau. Chaque élément du tableau spécifie les attributs d’un port virtuel (VPort) qui a été créé 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 :
Une structure NDIS_NIC_SWITCH_VPORT_INFO_ARRAY qui définit le nombre d’éléments dans le tableau.
Tableau de structures NDIS_NIC_SWITCH_VPORT_INFO . Chacune de ces structures contient des informations sur un VPort sur le commutateur de carte réseau de la carte réseau de la carte réseau.
Note Si aucun VPort n’a été créé sur la carte réseau, le pilote définit le membre NumElements de la structure NDIS_NIC_SWITCH_VPORT_INFO_ARRAY sur zéro et aucune structure NDIS_NIC_SWITCH_VPORT_INFO n’est retournée.
Notes
Les pilotes et les applications en mode utilisateur excessives émettent des requêtes OID de OID_NIC_SWITCH_ENUM_VPORTS pour énumérer les VPorts alloués sur le 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_VPORT_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_VPORT_INFO_ARRAY :
Si l’indicateur NDIS_NIC_SWITCH_VPORT_INFO_ARRAY_ENUM_ON_SPECIFIC_SWITCH est défini dans le membre Flags, les informations sont retournées pour tous les VPorts créés sur un commutateur de carte réseau spécifié. Le commutateur de carte réseau est spécifié par le membre SwitchId de cette structure.
Note À compter de Windows Server 2012, l’interface SR-IOV 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.
Si l’indicateur NDIS_NIC_SWITCH_VPORT_INFO_ARRAY_ENUM_ON_SPECIFIC_FUNCTION est défini dans le membre Indicateurs, des informations sont retournées pour tous les VPorts attachés à une fonction physique PCI Express (PCIe) ou une fonction virtuelle (VF) spécifiée sur la carte réseau. Le PF ou VF est spécifié par le membre AttachedFunctionId de cette structure.
Si le membre AttachedFunctionId est défini sur NDIS_PF_FUNCTION_ID, des informations sont retournées pour tous les VPorts, y compris le VPort par défaut, qui sont attachés au PF de la carte réseau. Si le membre AttachedFunctionId est défini sur un identificateur VF valide, des informations sont retournées pour tous les VPorts à la VF spécifiée.
Note À compter de Windows Server 2012, un seul VPort non par défaut peut être attaché à une VF. Toutefois, plusieurs VPorts (y compris le VPort par défaut) peuvent être attachés au PF.
Si le membre Flags est défini sur zéro, les informations sont retournées pour tous les VPorts attachés au PF ou à la VF sur la carte réseau. Dans ce cas, les valeurs de SwitchId et AttachedFunctionId sont ignorées.
Pour plus d’informations, consultez Énumération de ports virtuels sur une 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_VPORTS pour les pilotes miniport. Les pilotes ne seront pas émis cette demande OID.
Lorsque NDIS gère la requête OID_NIC_SWITCH_ENUM_VPORTS, 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) |