Partager via


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)

Voir aussi


NDIS_OID_REQUEST

NDIS_SRIOV_SET_VF_POWER_STATE_PARAMETERS

OID_NIC_SWITCH_ALLOCATE_VF