OID_SRIOV_SET_VF_POWER_STATE
Un pilote overlying é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 de l’alimentation est une opération privilégiée, les pilotes surlysant émettent cette demande définie par OID sur le 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.
Remarques
Lorsque le pilote pf miniport est émis cette demande de jeu d’OID, il 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_SET_VF_POWER_STATE_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 la machine virtuelle spécifiée n’est pas dans un état alloué, le pilote doit échouer à la requête OID.
L’opération d’état de l’alimentation 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 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 d’état suivants pour la requête 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 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 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) |