Partager via


OID_NIC_SWITCH_FREE_VF

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.

Spécifications

Version

Pris en charge dans NDIS 6.30 et versions ultérieures.

En-tête

Ntddndis.h (inclure Ndis.h)

Voir aussi


NDIS_NIC_SWITCH_FREE_VF_PARAMETERS

NDIS_OID_REQUEST

NdisCloseAdapterEx

OID_NIC_SWITCH_ALLOCATE_VF

OID_NIC_SWITCH_CREATE_VPORT

OID_NIC_SWITCH_DELETE_VPORT

OID_NIC_SWITCH_DELETE_SWITCH