OID_SRIOV_SET_VF_POWER_STATE
Un pilote qui se superpose émet une demande de jeu d’identificateur d’objet (OID) de OID_SRIOV_SET_VF_POWER_STATE pour modifier l’état d’alimentation d’une fonction virtuelle PCI Express (PCIe) spécifiée sur la carte réseau. Étant donné que la modification de l’état d’alimentation est une opération privilégiée, les pilotes trop élevés émettent cette demande de définition OID au pilote miniport de la fonction physique PCIe (PF) sur la carte réseau. Le pilote pf miniport définit ensuite l’état d’alimentation spécifié sur la VF.
Le membre InformationBuffer de la structure NDIS_OID_REQUEST contient un pointeur vers une structure NDIS_SRIOV_SET_VF_POWER_STATE_PARAMETERS .
Notes
Lorsque le pilote pf miniport est émis cette demande de jeu d’OID, il 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_SET_VF_POWER_STATE_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 la VF spécifiée n’est pas dans un état alloué, le pilote doit échouer à la requête OID.
L’opération d’état d’alimentation 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 Définition de l’état d’alimentation d’une fonction virtuelle.
Codes d’état de retour
Le pilote pf miniport retourne l’un des codes status suivants pour la demande de jeu d’OID de OID_SRIOV_SET_VF_POWER_STATE.
| 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_SET_VF_POWER_STATE_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) |