Énumération des commutateurs de carte réseau sur une carte réseau
Un pilote ou une application utilisateur qui se superpose peut obtenir la liste de tous les commutateurs de carte réseau qui ont été créés sur une carte réseau qui prend en charge la virtualisation d’E/S racine unique (SR-IOV). Le pilote ou l’application émet une requête d’identificateur d’objet (OID) de OID_NIC_SWITCH_ENUM_SWITCHES pour obtenir cette liste.
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.
Note À compter de Windows Server 2012, l’interface SR-IOV ne prend en charge qu’un seul commutateur de carte réseau sur la carte réseau. Ce commutateur est appelé commutateur de carte réseau par défaut et est référencé par l’identificateur NDIS_DEFAULT_SWITCH_ID.
NDIS gère la demande de OID_NIC_SWITCH_ENUM_SWITCHES pour les pilotes miniport. NDIS retourne les informations d’un cache interne des données qu’il gère à partir des sources suivantes :
Les paramètres sr-IOV standardisés mot clé dans le Registre. Pour plus d’informations sur ces mots clés, consultez Mots clés INF standardisés pour SR-IOV.
Demandes OID de OID_NIC_SWITCH_CREATE_SWITCH et de OID_NIC_SWITCH_PARAMETERS.
Note NDIS fournit également l’énumération des commutateurs dans le membre NicSwitchArray dans les structures NDIS_BIND_PARAMETERS et NDIS_FILTER_ATTACH_PARAMETERS . Par conséquent, le protocole et les pilotes de filtre qui se superposent n’ont pas besoin d’émettre OID_NIC_SWITCH_ENUM_SWITCHES demandes pour obtenir ces informations.