OID_NIC_SWITCH_DELETE_VPORT
Un pilote qui se superpose émet une demande de jeu d’identificateur d’objet (OID) de OID_NIC_SWITCH_DELETE_VPORT pour supprimer un port virtuel non par défaut (VPort) précédemment créé sur le commutateur de carte réseau d’une carte réseau. Le pilote qui se superpose peut supprimer un VPort qu’il a créé précédemment uniquement en émettant une demande de méthode OID de OID_NIC_SWITCH_CREATE_VPORT.
Les pilotes trop chargés émettent cette demande de définition OID sur le pilote miniport pour la fonction physique PCIe (PF) 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).
Le membre InformationBuffer de la structure NDIS_OID_REQUEST contient un pointeur vers la structure NDIS_NIC_SWITCH_DELETE_VPORT_PARAMETERS .
Notes
Un pilote trop haut, tel qu’un pilote de protocole ou de filtre, ne peut supprimer qu’un VPort non par défaut qu’il a créé précédemment. Le pilote qui se superpose crée un VPort en émettant une demande de méthode OID de OID_NIC_SWITCH_CREATE_VPORT.
Lorsque le pilote PF miniport reçoit la demande OID de OID_NIC_SWITCH_DELETE_VPORT, il doit libérer les ressources matérielles et logicielles qui ont été allouées pour le VPort spécifié.
Pour plus d’informations, consultez Suppression d’un port virtuel.
Note Seules les VPorts non par défaut peuvent être supprimées explicitement par le biais de requêtes OID de OID_NIC_SWITCH_DELETE_VPORT. Le VPort par défaut est implicitement supprimé lorsque le pilote pf miniport supprime le commutateur de carte réseau par défaut. Pour plus d’informations, consultez Suppression d’un commutateur de carte réseau.
Codes d’état de retour
Le pilote pf miniport renvoie l’un des codes status suivants pour la demande de jeu OID de OID_NIC_SWITCH_DELETE_VPORT.
| Code d’état | 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 de virtualisation d’E/S racine unique (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_DELETE_VPORT_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_DELETE_VPORT_PARAMETERS). Le pilote pf miniport doit définir les données. SET_INFORMATION. BytesNeeded membre dans la structure NDIS_OID_REQUEST à la taille de mémoire tampon minimale requise. |
NDIS_STATUS_FAILURE |
La demande a échoué pour d’autres raisons. |
Spécifications
Version |
Pris en charge dans NDIS 6.30 et versions ultérieures. |
En-tête |
Ntddndis.h (inclure Ndis.h) |