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