structure PEP_POWER_CONTROL_COMPLETE (pepfx.h)

Article
02/26/2024

La structure PEP_POWER_CONTROL_COMPLETE contient status informations pour une opération de contrôle d’alimentation que le PEP a demandée précédemment et que le pilote de périphérique a terminée.

Syntaxe

typedef struct _PEP_POWER_CONTROL_COMPLETE {
  [in] PEPHANDLE DeviceHandle;
  [in] LPCGUID   PowerControlCode;
  [in] PVOID     RequestContext;
  [in] SIZE_T    BytesReturned;
  [in] NTSTATUS  Status;
} PEP_POWER_CONTROL_COMPLETE, *PPEP_POWER_CONTROL_COMPLETE;

Membres

[in] DeviceHandle

Valeur PEPHANDLE qui identifie l’appareil. Le PEP a fourni ce handle en réponse à une notification PEP_DPM_REGISTER_DEVICE précédente.

[in] PowerControlCode

Pointeur vers une valeur GUID qui spécifie l’opération de contrôle d’alimentation effectuée. Il s’agit de la même valeur que celle fournie par le PEP en réponse à la notification PEP_DPM_WORK pour lancer l’opération de contrôle d’alimentation.

[in] RequestContext

Pointeur vers le contexte de demande envoyé par le PEP dans la structure PEP_WORK_INFORMATION fournie par le PEP dans la demande de travail d’origine. En règle générale, ce membre pointe vers une structure qui contient un pointeur vers une mémoire tampon de sortie pour contenir les résultats de l’opération de contrôle d’alimentation demandée par le PEP.

[in] BytesReturned

Taille, en octets, des données de résultat stockées par le pilote dans la mémoire tampon de sortie. Pour plus d’informations sur cette mémoire tampon, consultez la description du membre RequestContext .

[in] Status

Status de l’opération de contrôle d’alimentation. Si l’opération a réussi, le PEP définit ce membre sur STATUS_SUCCESS. Sinon, le PEP définit ce membre sur une erreur appropriée status code.

Remarques

Cette structure est utilisée par la notification PEP_DPM_POWER_CONTROL_COMPLETE . Les cinq membres de la structure contiennent des valeurs d’entrée fournies par

Si la mémoire tampon de sortie est trop petite pour recevoir toutes les données de résultat de l’opération, le PEP définit le membre Status de la structure sur STATUS_INSUFFICIENT_RESOURCES, définit le membre BytesReturned sur la taille requise de la mémoire tampon de sortie et (généralement) n’écrit aucune donnée dans la mémoire tampon de sortie.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Pris en charge à partir de Windows 10.
En-tête	pepfx.h (include Pep_x.h)

Voir aussi

GUID

Partager via