Création statique d’un commutateur de carte réseau

Une carte réseau qui prend en charge la virtualisation d’E/S racine unique (SR-IOV) doit être en mesure de créer un commutateur de carte réseau. Pour certaines cartes, le commutateur de carte réseau peut être créé de manière statique dans le contexte de l’appel à MiniportInitializeEx.

Seul le pilote miniport pour la fonction physique PCI Express (PCIe) de l’adaptateur SR-IOV peut créer un commutateur de carte réseau sur l’adaptateur.

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.

Les paramètres du commutateur de carte réseau par défaut sont définis via des paramètres de mot clé standardisés dans le Registre. Pour plus d’informations sur ces mots clés, consultez Mots clés INF standardisés pour SR-IOV.

Le pilote pf miniport crée statiquement le commutateur de carte réseau lorsque NDIS appelle la fonction MiniportInitializeEx du pilote. En règle générale, le pilote crée et configure le commutateur de carte réseau dans le cadre de sa séquence d’initialisation avant d’activer SR-IOV sur la carte réseau.

Le pilote pf miniport effectue ces étapes lorsqu’il crée statiquement le commutateur de carte réseau et active SR-IOV sur la carte réseau dans le contexte de l’appel à MiniportInitializeEx :

  1. Le pilote pf miniport doit lire les mots clés standardisés SR-IOV pour déterminer si SR-IOV est activé et obtenir les paramètres de configuration du commutateur de carte réseau.

    Note Si le pilote PF miniport a inscrit un point d’entrée à une fonction MiniportSetOptions , il a peut-être déjà obtenu ces paramètres à partir du Registre lorsque NDIS a appelé MiniportSetOptions.

  2. Si SR-IOV est activé, le pilote pf miniport configure la carte réseau avec les paramètres de commutateur de carte réseau du Registre. Le pilote doit vérifier que les paramètres sont valides avant de configurer la carte réseau. Par exemple, le pilote miniport doit vérifier que le nombre maximal de fonctions virtuelles PCIe attribuées au commutateur de carte réseau ne dépasse pas le nombre de machines virtuelles prises en charge par la carte réseau.

  3. Le pilote miniport appelle NdisMEnableVirtualization pour activer SR-IOV et définir le nombre de machines virtuelles sur la carte réseau. Cette fonction configure la fonctionnalité étendue SR-IOV dans l’espace de configuration PCI de l’adaptateur. Si cette fonction retourne NDIS_STATUS_SUCCESS, SR-IOV est activé et les machines virtuelles sont exposées via l’interface PCIe.

Note Si le pilote pf miniport crée statiquement le commutateur de carte réseau, le commutateur ne peut pas être utilisé tant que NDIS n’émet pas une demande de méthode d’identificateur d’objet (OID) de OID_NIC_SWITCH_CREATE_SWITCH. Si le pilote pf miniport a créé statiquement le commutateur de carte réseau, il doit vérifier que les paramètres du commutateur sont spécifiés dans la requête OID. Ces paramètres, tels qu’ils sont contenus dans la structure NDIS_NIC_SWITCH_PARAMETERS associée à la requête OID, doivent être identiques aux paramètres utilisés par le pilote pour créer le commutateur.

Pour plus d’informations sur la gestion de la demande de OID_NIC_SWITCH_CREATE_SWITCH , consultez Gestion de la demande de OID_NIC_SWITCH_CREATE_SWITCH.

Pour plus d’informations sur la séquence d’initialisation et la configuration requise pour les pilotes pf miniport, consultez Initialisation d’un pilote PF Miniport.