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 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 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_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 relatives à un commutateur de carte réseau unique créé sur la carte réseau.
Remarque Si la carte réseau n’a pas de commutateurs de carte réseau, le pilote définit le membre NumElements de la structure de NDIS_NIC_SWITCH_INFO_ARRAY sur zéro et aucune structure NDIS_NIC_SWITCH_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_SWITCHES pour énumérer les commutateurs de carte réseau créés sur une carte réseau.
Remarque à partir de Windows Server 2012, l’interface 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 élément NDIS_NIC_SWITCH_INFO unique 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 de requête OID de la requête OID_NIC_SWITCH_ENUM_SWITCHES pour les pilotes miniports. Les pilotes ne seront pas émis cette demande OID.
Lorsque NDIS gère la requête OID_NIC_SWITCH_ENUM_SWITCHES, 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 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 le DATA. QUERY_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) |