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) |