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) |