OID_NIC_SWITCH_FREE_VF

Article
03/13/2025

Un pilote overlying émet une demande de jeu d’identificateur d’objet (OID) de OID_NIC_SWITCH_FREE_VF pour libérer les ressources pour la fonction virtuelle PCI Express (PCIe) d’une carte réseau.

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 une structure NDIS_NIC_SWITCH_FREE_VF_PARAMETERS.

Le pilote overlying spécifie l’identificateur de la machine virtuelle à libérer via le VFId membre de cette structure. Le pilote a obtenu cet identificateur à partir d’une demande de méthode OID antérieure de OID_NIC_SWITCH_ALLOCATE_VF.

Remarques

Un pilote surlysant émet une demande de jeu d’OID de OID_NIC_SWITCH_FREE_VF pour libérer les ressources d’une machine virtuelle. Ces ressources ont été précédemment allouées via une requête de méthode OID de OID_NIC_SWITCH_ALLOCATE_VF.

Pour plus d’informations sur la gratuité des ressources VF, consultez Ressources de libération pour une fonction virtuelle.

Remarque Une fois qu’un pilote surlysant demande l’allocation de ressources pour une machine virtuelle, ce pilote est le seul composant qui peut demander la libération des ressources pour la même machine virtuelle. Le pilote overlying doit émettre une demande de jeu OID de OID_NIC_SWITCH_FREE_VF pour libérer les ressources VF. Avant que le pilote surchargé puisse être arrêté, il doit libérer les ressources de chaque VF allouée par la demande de OID_NIC_SWITCH_ALLOCATE_VF du pilote.

Retourner des codes d’état

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_FREE_VF_PARAMETERS ont des valeurs non valides. Par exemple, le VFId membre peut spécifier un VF qui n’a pas été alloué ou qui a des ports virtuels qui n’ont pas été supprimés.
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.