structure PEP_POWER_CONTROL_COMPLETE (pep_x.h)

Article
02/07/2025

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

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 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 requête envoyé par le PEP dans la structure PEP_WORK_INFORMATION fournie 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

État 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 un code d’état d’erreur approprié.

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 l’état membre de la structure sur STATUS_INSUFFICIENT_RESOURCES, définit le membre BytesReturned à 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.

Exigences

Exigence	Valeur
client minimum pris en charge	Prise en charge à partir de Windows 10.
d’en-tête	pep_x.h (inclure Pep_x.h)

Voir aussi

GUID

Partager via