OID_NIC_SWITCH_FREE_VF

Article
06/15/2023

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

Les pilotes sur-ment émettent cette demande de définition OID au 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 une structure NDIS_NIC_SWITCH_FREE_VF_PARAMETERS .

Le pilote overlying spécifie l’identificateur du VF à libérer via le membre VFId 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.

Notes

Un pilote overlying é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 demande de méthode OID de OID_NIC_SWITCH_ALLOCATE_VF.

Pour plus d’informations sur la façon de libérer des ressources VF, consultez Libérer des ressources pour une fonction virtuelle.

Note Une fois qu’un pilote excessivement demande l’allocation de ressources pour une VF, 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 d’OID de OID_NIC_SWITCH_FREE_VF pour libérer les ressources VF. Avant de pouvoir arrêter le pilote qui se superpose, il doit libérer les ressources pour chaque VF qui a été allouée par la demande de OID_NIC_SWITCH_ALLOCATE_VF du pilote.

Retourner les codes status

La fonction MiniportOidRequest du pilote miniport retourne 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 termine 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 en cours de réinitialisation.
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 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 membre VFId peut spécifier un VF qui n’a pas été alloué ou qui a des VPorts qui n’ont pas été supprimés.
NDIS_STATUS_INVALID_LENGTH	La mémoire tampon d’informations est trop petite. NDIS définit les DONNÉES. SET_INFORMATION. Le membre BytesNeeded dans le NDIS_OID_REQUEST structure à la taille de mémoire tampon minimale requise.