OID_NIC_SWITCH_CREATE_SWITCH

Article
06/15/2023

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 (PF) PCI Express (PCIe) de la carte réseau. Cette demande de méthode OID est requise pour les pilotes pf miniport qui prennent en charge l’interface de virtualisation d’E/S racine unique (SR-IOV).

Note Les pilotes sur-ment, tels que les pilotes de protocole ou de filtre, ne peuvent pas émettre de demandes de méthode OID de OID_NIC_SWITCH_CREATE_SWITCH au pilote pf miniport.

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

Notes

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 :

Si le pilote miniport PF prend en charge la création et la configuration de commutateurs statiques, 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 lors de l’appel à MiniportInitializeEx. Si ce n’est pas le cas, le pilote doit échouer à la requête OID.

Pour plus d’informations, consultez Création statique d’un commutateur de carte réseau.
Si le pilote pf miniport prend en charge la création et la configuration de commutateurs dynamiques, 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.
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.

Note Le VPort par défaut est toujours créé via une requête OID de OID_NIC_SWITCH_CREATE_SWITCH et supprimé via 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 VPorts non définis par défaut sur le commutateur de carte réseau.
Le pilote PF miniport qui prend en charge la création et la configuration de commutateurs dynamiques doit activer la virtualisation SR-IOV sur le commutateur en appelant NdisMEnableVirtualization. Cet appel configure le membre NumVFs et le bit Enable VF 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 Single Root I/O Virtualization and Sharing 1.1 .

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

Si le pilote pf miniport effectue correctement la demande de méthode OID de OID_NIC_SWITCH_CREATE_SWITCH, les opérations suivantes se produisent :

Les machines virtuelles peuvent être allouées sur le commutateur de carte réseau via des demandes de méthode OID de OID_NIC_SWITCH_ALLOCATE_VF.
Des VPorts non définis par défaut 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 gestion de cette requête OID, consultez Gestion de la demande OID_NIC_SWITCH_CREATE_SWITCH.

Codes d’état de retour

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

Code d’état	Description
NDIS_STATUS_SUCCESS	La requête OID s’est terminée avec succès.
NDIS_STATUS_NOT_SUPPORTED	Le pilote pf 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_PARAMETERS ont des valeurs non valides.
NDIS_STATUS_INVALID_LENGTH	La longueur de la mémoire tampon d’informations est inférieure à sizeof(NDIS_NIC_SWITCH_PARAMETERS). Le pilote pf miniport doit définir les DONNÉES. METHOD_INFORMATION. Le membre BytesNeeded dans le NDIS_OID_REQUEST structure à la taille de mémoire tampon minimale requise.
NDIS_STATUS_FAILURE	La demande a échoué pour d’autres raisons.