OID_NIC_SWITCH_ENUM_SWITCHES

Un pilote ou une application en mode utilisateur excessive émet une requête d’identificateur d’objet (OID) de OID_NIC_SWITCH_ENUM_SWITCHES pour obtenir un tableau. Chaque élément du tableau spécifie les attributs d’un commutateur de carte réseau qui a été créé sur 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_INFO_ARRAY qui définit le nombre d’éléments dans le tableau.

• Tableau de structures NDIS_NIC_SWITCH_INFO . Chacune de ces structures contient les informations sur un seul commutateur de carte réseau créé sur la carte réseau.

  Note Si la carte réseau n’a pas de commutateurs de carte réseau, le pilote définit le membre NumElements de la structure NDIS_NIC_SWITCH_INFO_ARRAY sur zéro et aucune structure NDIS_NIC_SWITCH_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_SWITCHES pour énumérer les commutateurs de carte réseau créés sur une carte réseau.

Note À compter de Windows Server 2012, l’interface de virtualisation d’E/S racine unique (SR-IOV) prend uniquement en charge le commutateur de carte réseau par défaut sur la carte réseau. Par conséquent, la structure de NDIS_NIC_SWITCH_INFO_ARRAY retournée doit spécifier un seul élément NDIS_NIC_SWITCH_INFO pour le commutateur de carte réseau par défaut, qui est référencé par l’identificateur de NDIS_DEFAULT_SWITCH_ID.

Codes d’état de retour

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

Lorsque NDIS gère la demande de OID_NIC_SWITCH_ENUM_SWITCHES, 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 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_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. QUERY_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_INFO

NDIS_NIC_SWITCH_INFO_ARRAY

NDIS_OID_REQUEST

OID_NIC_SWITCH_CREATE_SWITCH

OID_NIC_SWITCH_PARAMETERS