OID_NIC_SWITCH_DELETE_SWITCH

Article
06/15/2023

NDIS émet une demande d’ensemble 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 envoie cette demande de set OID au pilote miniport de la fonction physique (PF) PCI Express (PCIe) de la carte réseau. Cette demande de jeu d’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 trop lysés, tels que les pilotes de protocole ou de filtre, ne peuvent pas émettre cette demande de méthode OID au pilote PF miniport.

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

Notes

Une demande de jeu OID de OID_NIC_SWITCH_DELETE_SWITCH supprime un commutateur de carte réseau qui a été créé précédemment via une demande 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 et la configuration statiques de commutateurs de cartes 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 les ressources matérielles du commutateur de carte réseau que lorsque MiniportHaltEx est appelé.

Pour plus d’informations sur la création de commutateurs de cartes réseau statiques, 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 dynamiques de 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 d’un commutateur de carte réseau dynamique, consultez Création dynamique d’un commutateur de carte réseau.
Si le pilote pf miniport 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 la carte 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 bit Enable VF dans la structure de capacité étendue SR-IOV dans l’espace de configuration PCI du PF de la carte réseau.

Note Si le pilote pf miniport prend en charge la création et la configuration statiques de commutateurs de cartes réseau, il doit uniquement 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 fonction MiniportOidRequest du pilote miniport renvoie l’une des valeurs suivantes pour cette requête :

Terme	Description
NDIS_STATUS_SUCCESS	Le pilote miniport a effectué la demande avec succès.
NDIS_STATUS_PENDING	Le pilote miniport effectue la requête de manière asynchrone. Une fois que le pilote miniport a terminé tout le traitement, il doit réussir la demande 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 cessé de traiter la demande. Par exemple, NDIS a appelé la fonction MiniportResetEx .

NDIS retourne l’un des codes status suivants pour cette demande :

Terme	Description
NDIS_STATUS_SUCCESS	La demande 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 les DONNÉES. SET_INFORMATION. BytesNeeded membre dans la structure NDIS_OID_REQUEST à la taille de mémoire tampon minimale requise.