Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Les pilotes surcharinés émettent une demande de jeu d’identificateur d’objet (OID) de OID_SRIOV_RESET_VF pour réinitialiser une fonction virtuelle PCI Express (PCIe) spécifiée sur une carte réseau qui prend en charge la virtualisation d’E/S racine unique. Le surlysage des pilotes émet cette demande définie par OID sur le pilote miniport de la fonction physique PCI Express (PCIe) de la carte réseau.
Le InformationBuffer membre 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 machine virtuelle à réinitialiser via le VFId membre de cette structure.
Remarques
Une machine virtuelle peut être réinitialisée via une réinitialisation de niveau de fonction PCI Express (PCIe) (FLR). É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 miniport PF.
Quand il gère cette demande OID, le pilote pf miniport doit suivre ces instructions :
Le pilote pf miniport doit vérifier que le VF, spécifié par le VFId membre de la structure NDIS_SRIOV_RESET_VF_PARAMETERS, a des ressources qui ont été précédemment allouées. Le pilote PF miniport alloue des ressources pour une machine virtuelle pendant une demande de méthode OID de OID_NIC_SWITCH_ALLOCATE_VF. Si les ressources de la fonction virtuelle spécifiée n’ont pas été allouées, le pilote doit échouer à la requête OID.
L’opération de réinitialisation ne doit affecter que le VF spécifié. L’opération ne doit pas affecter d’autres machines virtuelles ou le 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 d’état suivants pour la demande définie 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 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 la DATA. SET_INFORMATION. OctetsNeeded membre de la structure NDIS_OID_REQUEST à la taille de mémoire tampon minimale requise. |
NDIS_STATUS_FAILURE |
La demande a échoué pour d’autres raisons. |
Exigences
Version |
Prise en charge dans NDIS 6.30 et versions ultérieures. |
En-tête |
Ntddndis.h (include Ndis.h) |