OID_NIC_SWITCH_DELETE_SWITCH

Article
03/13/2025

NDIS émet une demande de jeu d’identificateur d’objet (OID) de OID_NIC_SWITCH_DELETE_SWITCH pour supprimer un commutateur de carte réseau d’une carte réseau.

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

Remarque pilotes overlying, tels que les pilotes de protocole ou de filtre, ne peut pas émettre cette demande de méthode OID au pilote miniport PF.

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

Remarques

Une demande de jeu d’OID de OID_NIC_SWITCH_DELETE_SWITCH supprime un commutateur de carte réseau créé précédemment par le biais d’une requête de méthode OID de OID_NIC_SWITCH_CREATE_SWITCH.

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

Si le pilote pf miniport prend en charge la création statique et la configuration des commutateurs de carte réseau, il doit libérer les ressources logicielles associées au commutateur de carte réseau spécifié. Toutefois, le pilote ne peut libérer que les ressources matérielles du commutateur de carte réseau lorsque MiniportHaltEx est appelée.

Pour plus d’informations sur la création du commutateur de carte réseau statique, consultez Création statique d’un commutateur de carte réseau.
Si le pilote miniport PF prend en charge la création dynamique et la configuration des commutateurs de carte réseau, il doit libérer les ressources matérielles et logicielles associées au commutateur de carte réseau spécifié.

Pour plus d’informations sur la création de commutateurs de carte réseau dynamique, consultez Création dynamique d’un commutateur de carte réseau.
Si le pilote miniport PF prend en charge la création dynamique et que tous les commutateurs de carte réseau ont été supprimés, le pilote doit désactiver la virtualisation sur l’adaptateur en appelant NdisMEnableVirtualization. Pour désactiver la virtualisation, la carte réseau doit définir le paramètre EnableVirtualization sur FALSE et le paramètre NumVFs sur zéro.

NdisMEnableVirtualization efface le membre NumVFs et le VF Activer bit dans la structure de capacité étendue SR-IOV dans l’espace de configuration PCI de la carte réseau PF.

Remarque Si le pilote miniport PF prend en charge la création statique et la configuration des commutateurs de carte réseau, il ne doit appeler NdisMEnableVirtualization lorsque MiniportHaltEx est appelé.

Pour plus d’informations, consultez Suppression d’un commutateur de carte réseau.

Codes d’état de retour

La fonctionminiportdu pilote miniportOidRequest retourne l’une des valeurs suivantes pour cette requête :

Terme	Description
NDIS_STATUS_SUCCESS	Le pilote miniport a terminé la requête avec succès.
NDIS_STATUS_PENDING	Le pilote miniport termine la requête de manière asynchrone. Une fois que le pilote miniport a terminé tout le traitement, il doit réussir la requête en appelant la fonction NdisMOidRequestComplete, en passant NDIS_STATUS_SUCCESS pour le paramètre Status.
NDIS_STATUS_NOT_ACCEPTED	Le pilote miniport est réinitialisé.
NDIS_STATUS_REQUEST_ABORTED	Le pilote miniport a arrêté le traitement de la requête. Par exemple, NDIS a appelé la fonction MiniportResetEx.

NDIS retourne l’un des codes d’état suivants pour cette demande :

Terme	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_FILE_NOT_FOUND	Un ou plusieurs des membres de la structure NDIS_NIC_SWITCH_DELETE_SWITCH_PARAMETERS ont des valeurs non valides.
NDIS_STATUS_INVALID_LENGTH	La mémoire tampon d’informations est trop petite. NDIS définit le DATA. SET_INFORMATION. OctetsNeeded membre de la structure NDIS_OID_REQUEST à la taille de mémoire tampon minimale requise.