Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
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_VPORTS pour obtenir un tableau. Chaque élément du tableau spécifie les attributs d’un port virtuel (VPort) 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 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_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.
Remarque Si aucun VPorts n’a été créé sur la carte réseau, le pilote définit les NombreElements membre de la structure NDIS_NIC_SWITCH_VPORT_INFO_ARRAY sur zéro et aucune structure NDIS_NIC_SWITCH_VPORT_INFO n’est retournée.
Remarques
Le dépassement des pilotes et des applications en mode utilisateur émet des requêtes OID de OID_NIC_SWITCH_ENUM_VPORTS pour énumérer les ports virtuels alloués sur le 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 NDIS_NIC_SWITCH_VPORT_INFO_ARRAY qui est passée avec la requête. 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 les indicateurs membre, les informations sont retournées pour tous les ports virtuels créés sur un commutateur de carte réseau spécifié. Le commutateur de carte réseau est spécifié par le SwitchId membre de cette structure.
Remarque à partir 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 indicateurs de, le switchId membre 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 les indicateurs de membre, les informations sont retournées pour tous les ports virtuels attachés à une fonction physique PCI Express (PCIe) spécifiée (PF) ou une fonction virtuelle (VF) sur la carte réseau. Le PF ou VF est spécifié par le AttachedFunctionId membre de cette structure.
Si l'AttachedFunctionId membre est défini sur NDIS_PF_FUNCTION_ID, les informations sont retournées pour tous les ports virtuels, y compris le VPort par défaut, qui sont attachés au pf de la carte réseau. Si le AttachedFunctionId membre est défini sur un identificateur VF valide, les informations sont retournées pour tous les ports virtuels à la valeur VF spécifiée.
Remarque à partir de Windows Server 2012, une seule fenêtre virtuelle non définie peut être attachée à une machine virtuelle. Toutefois, plusieurs VPorts (y compris le VPort par défaut) peuvent être attachés au PF.
Si les indicateurs membre ont la valeur zéro, les informations sont retournées pour tous les ports virtuels attachés au PF ou VF sur la carte réseau. Dans ce cas, les valeurs des 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 requête 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, 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. |
Exigences
Version |
Prise en charge dans NDIS 6.30 et versions ultérieures. |
En-tête |
Ntddndis.h (include Ndis.h) |