OID_SRIOV_RESET_VF

Les pilotes sur-ment émettent une demande de jeu d’identificateur d’objet (OID) de OID_SRIOV_RESET_VF pour réinitialiser une fonction virtuelle (VF) PCI Express (PCIe) spécifiée sur une carte réseau qui prend en charge la virtualisation d’E/S racine unique. Les pilotes sur-ment émettent cette demande de définition OID au pilote miniport de la fonction physique (PF) PCI Express (PCIe) de la carte réseau.

Le membre InformationBuffer de la structure NDIS_OID_REQUEST contient un pointeur vers une structure NDIS_SRIOV_RESET_VF_PARAMETERS . Le pilote overlying spécifie l’identificateur de la VF à réinitialiser via le membre VFId de cette structure.

Notes

Une VF peut être réinitialisée par le biais d’une réinitialisation de niveau de fonction (FLR) PCI Express (PCIe). Étant donné que la requête FLR est une opération privilégiée, elle ne peut être effectuée que par le pilote pf miniport qui s’exécute dans le système d’exploitation de gestion d’une partition parente Hyper-V. Les pilotes qui s’exécutent dans le système d’exploitation de gestion sont avertis de la demande FLR et émettent la demande de jeu d’OID de OID_SRIOV_RESET_VF au pilote pf miniport.

Lorsqu’il gère cette requête OID, le pilote pf miniport doit suivre les instructions suivantes :

• Le pilote pf miniport doit vérifier que le VF, spécifié par le membre VFId de la structure NDIS_SRIOV_RESET_VF_PARAMETERS , dispose de ressources qui ont été précédemment allouées. Le pilote miniport PF alloue des ressources pour une machine virtuelle lors d’une demande de méthode OID de OID_NIC_SWITCH_ALLOCATE_VF. Si les ressources pour le VF spécifié n’ont pas été allouées, le pilote doit échouer la requête OID.

• L’opération de réinitialisation doit uniquement affecter la VF spécifiée. L’opération ne doit pas affecter d’autres machines virtuelles ou pf sur la même carte réseau.

Pour plus d’informations, consultez Réinitialiser une fonction virtuelle.

Codes d’état de retour

Le pilote pf miniport retourne l’un des codes status suivants pour la demande d’ensemble de OID_SRIOV_RESET_VF.

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 de virtualisation 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_SRIOV_RESET_VF_PARAMETERS ont des valeurs non valides.
NDIS_STATUS_INVALID_LENGTH	La mémoire tampon d’informations était trop courte. Le pilote pf miniport doit définir les DONNÉES. SET_INFORMATION. Le membre BytesNeeded dans le NDIS_OID_REQUEST structure à la taille de mémoire tampon minimale requise.
NDIS_STATUS_FAILURE	La demande a échoué pour d’autres raisons.

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_OID_REQUEST

NDIS_SRIOV_RESET_VF_PARAMETERS

OID_NIC_SWITCH_ALLOCATE_VF