OID_NIC_SWITCH_CREATE_SWITCH

NDIS émet une demande de méthode d’identificateur d’objet (OID) de OID_NIC_SWITCH_CREATE_SWITCH pour créer un commutateur de carte réseau sur une carte réseau. Lorsqu’il gère cette requête OID, le pilote miniport alloue les ressources pour le commutateur de carte réseau sur l’adaptateur.

NDIS émet cette demande de méthode OID au pilote miniport de la fonction physique PCI Express (PCIe) de la carte réseau. Cette demande de méthode OID est requise pour les pilotes miniport PF qui prennent en charge l’interface de virtualisation d’E/S racine unique (SR-IOV).

Remarque les pilotes overlying, tels que les pilotes de protocole ou de filtre, ne peuvent pas émettre des requêtes de méthode OID de OID_NIC_SWITCH_CREATE_SWITCH au pilote miniport PF.

Le membre InformationBuffer de la structure NDIS_OID_REQUEST contient un pointeur vers une structure NDIS_NIC_SWITCH_PARAMETERS.

Remarques

Lorsqu’il reçoit la demande de méthode OID de OID_NIC_SWITCH_CREATE_SWITCH, le pilote pf miniport doit effectuer les opérations suivantes :

1. Si le pilote pf miniport prend en charge la création et la configuration du commutateur statique, il crée le commutateur de carte réseau lorsque NDIS appelle MiniportInitializeEx. Lorsque le pilote gère cette requête OID, il doit vérifier les paramètres de configuration dans la structure NDIS_NIC_SWITCH_PARAMETERS. Les paramètres doivent être identiques à ceux utilisés par le pilote pour créer le commutateur pendant l’appel à MiniportInitializeEx. Si ce n’est pas vrai, le pilote doit échouer à la requête OID.

   Pour plus d’informations, consultez Création statique d’un commutateur de carte réseau.

2. Si le pilote pf miniport prend en charge la création et la configuration de commutateur dynamique, le pilote doit valider les valeurs de configuration de la structure NDIS_NIC_SWITCH_PARAMETERS et créer le commutateur de carte réseau en fonction de ces valeurs.

   Pour plus d’informations, consultez création dynamique d’un commutateur de carte réseau.

3. Le pilote PF miniport doit allouer les ressources matérielles et logicielles nécessaires pour le VPort par défaut sur le commutateur de carte réseau.

   Remarque Le VPort par défaut est toujours créé par le biais d’une requête OID de OID_NIC_SWITCH_CREATE_SWITCH et supprimé par le biais d’une requête OID de OID_NIC_SWITCH_DELETE_SWITCH. Les requêtes OID de OID_NIC_SWITCH_CREATE_VPORT et de OID_NIC_SWITCH_DELETE_VPORT sont utilisées pour la création et la suppression de ports virtuels non définis sur le commutateur de carte réseau.

4. Le pilote pf miniport qui prend en charge la création et la configuration du commutateur dynamique doivent activer SR-IOV virtualisation sur le commutateur en appelant NdisMEnableVirtualization. Cet appel configure le membre numVFs et le VF Enable bit dans la structure de capacité étendue SR-IOV de l’espace de configuration PCI Express (PCIe) de l’adaptateur.

   Pour plus d’informations sur l’espace de configuration SR-IOV, consultez la spécification PCI-SIG virtualisation d’E/S racine unique et partage 1.1.

   Remarque Si le pilote miniport PF prend en charge la création du commutateur statique, il active SR-IOV virtualisation après avoir créé le commutateur lorsque MiniportInitializeEx est appelé.

Si le pilote miniport PF termine correctement la demande de méthode OID de OID_NIC_SWITCH_CREATE_SWITCH, il permet d’effectuer les opérations suivantes :

• Les machines virtuelles peuvent être allouées sur le commutateur de carte réseau via des requêtes de méthode OID de OID_NIC_SWITCH_ALLOCATE_VF.

• Les ports virtuels non définis peuvent être créés sur le commutateur de carte réseau via des requêtes de méthode OID de OID_NIC_SWITCH_CREATE_VPORT.

Pour plus d’informations sur la façon de gérer cette requête OID, consultez Gestion desde requête OID_NIC_SWITCH_CREATE_SWITCH.

Codes d’état de retour

Le pilote pf miniport retourne l’un des codes d’état suivants pour la demande de méthode OID de OID_NIC_SWITCH_CREATE_SWITCH.

Exigences

Voir aussi

MiniportInitializeEx

NDIS_OID_REQUEST

NDIS_NIC_SWITCH_PARAMETERS

NdisMEnableVirtualization

OID_NIC_SWITCH_ALLOCATE_VF

OID_NIC_SWITCH_CREATE_VPORT