Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Un pilote overlying émet une demande de jeu d’identificateur d’objet (OID) de OID_NIC_SWITCH_DELETE_VPORT pour supprimer un port virtuel non défini (VPort) créé précédemment sur le commutateur de carte réseau d’une carte réseau. Le pilote overlying peut supprimer un VPort qu’il a créé précédemment uniquement en émettant une requête de méthode OID de OID_NIC_SWITCH_CREATE_VPORT.
Le dépassement des pilotes émet cette demande définie par OID sur le pilote miniport pour la fonction physique PCIe de la carte réseau (PF). 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).
Le membre InformationBuffer de la structure NDIS_OID_REQUEST contient un pointeur vers la structure NDIS_NIC_SWITCH_DELETE_VPORT_PARAMETERS.
Remarques
Un pilote overlying, tel qu’un protocole ou un pilote de filtre, ne peut supprimer qu’un VPort nondefault qu’il a créé précédemment. Le pilote overlying crée un VPort en émettant une requête 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, le pilote 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.
Remarque Seuls les ports virtuels non définis peuvent être supprimés explicitement par le biais de requêtes OID de OID_NIC_SWITCH_DELETE_VPORT. La fenêtre VPort par défaut est implicitement supprimée 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 retourne l’un des codes d’état suivants pour la demande de jeu d’OID de OID_NIC_SWITCH_DELETE_VPORT.
| 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 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 la DATA. SET_INFORMATION. OctetsNeeded membre de la structure NDIS_OID_REQUEST à la taille de mémoire tampon minimale requise. |
NDIS_STATUS_FAILURE |
La demande a échoué pour d’autres raisons. |
Exigences
Version |
Prise en charge dans NDIS 6.30 et versions ultérieures. |
En-tête |
Ntddndis.h (include Ndis.h) |