Partager via


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 :

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