structure PEP_POWER_CONTROL_REQUEST (pepfx.h)

La structure PEP_POWER_CONTROL_REQUEST contient une requête d’un pilote pour une opération de contrôle d’alimentation.

Syntaxe

typedef struct _PEP_POWER_CONTROL_REQUEST {
  [in]  PEPHANDLE DeviceHandle;
  [in]  LPCGUID   PowerControlCode;
  [in]  PVOID     InBuffer;
  [in]  SIZE_T    InBufferSize;
  [in]  PVOID     OutBuffer;
  [in]  SIZE_T    OutBufferSize;
  [out] SIZE_T    BytesReturned;
  [out] NTSTATUS  Status;
} PEP_POWER_CONTROL_REQUEST, *PPEP_POWER_CONTROL_REQUEST;

Membres

[in] DeviceHandle

Valeur PEPHANDLE qui identifie l’appareil. Le point de terminaison privilégié 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 à effectuer. Il s’agit de la même valeur que celle fournie par le pilote demandeur en tant que paramètre PowerControlCode à la routine PoFxPowerControl .

[in] InBuffer

Pointeur vers une mémoire tampon d’entrée allouée par le pilote qui contient les paramètres d’entrée pour cette opération de contrôle d’alimentation. Il s’agit de la même valeur que celle fournie par le pilote demandeur en tant que paramètre InBuffer à la routine PoFxPowerControl .

[in] InBufferSize

Taille en octets de la mémoire tampon pointée par InBuffer. Il s’agit de la même valeur que celle fournie par le pilote demandeur en tant que paramètre InBufferSize à la routine PoFxPowerControl .

[in] OutBuffer

Pointeur vers une mémoire tampon de sortie allouée par le pilote dans laquelle le point de terminaison privilégié écrit les résultats de cette opération de contrôle d’alimentation. Il s’agit de la même valeur que celle fournie par le pilote demandeur en tant que paramètre OutBuffer à la routine PoFxPowerControl .

[in] OutBufferSize

Taille en octets de la mémoire tampon pointée par OutBuffer.

[out] BytesReturned

Nombre d’octets que le point de terminaison privilégié a écrit dans la mémoire tampon de sortie pointée par OutBuffer.

[out] Status

État de l’opération de contrôle d’alimentation demandée. Si l’opération réussit, le point de terminaison privilégié affecte à ce membre la valeur STATUS_SUCCESS. Sinon, le point de terminaison privilégié 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_REQUEST . Les six premiers membres de la structure contiennent des valeurs d’entrée fournies par le Windows Power Management Framework (PoFx). Les deux derniers membres contiennent des valeurs que le pep écrit dans la structure en réponse à cette notification. En outre, le point de terminaison privilégié écrit dans la mémoire tampon de sortie vers laquelle pointe le membre OutBuffer .

Si la mémoire tampon de sortie est trop petite pour recevoir toutes les données de résultat de l’opération, le point de terminaison privilégié définit le membre Status 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.

Le pilote d’un appareil peut appeler la routine PoFxPowerControl pour demander une opération de contrôle d’alimentation sur l’appareil. Pendant cet appel, PoFx délègue la gestion de cette demande au point de terminaison privilégié propriétaire de l’appareil. Le membre PowerControlCode de la structure PEP_POWER_CONTROL_REQUEST contient un code de contrôle personnalisé dont la signification est comprise à la fois par le pilote et le point de terminaison privilégié pour l’appareil.

Configuration requise

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

Voir aussi

PEP_DPM_POWER_CONTROL_REQUEST

PEP_DPM_REGISTER_DEVICE

PoFxPowerControl