estructura PEP_POWER_CONTROL_REQUEST (pepfx.h)

La estructura PEP_POWER_CONTROL_REQUEST contiene una solicitud de un controlador para una operación de control de energía.

Sintaxis

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;

Miembros

[in] DeviceHandle

Valor PEPHANDLE que identifica el dispositivo. El PEP proporcionó este identificador en respuesta a una notificación de PEP_DPM_REGISTER_DEVICE anterior.

[in] PowerControlCode

Puntero a un valor GUID que especifica la operación de control de energía que se va a realizar. Este es el mismo valor que el controlador solicitante proporcionado como el parámetro PowerControlCode a la rutina PoFxPowerControl .

[in] InBuffer

Puntero a un búfer de entrada asignado por el controlador que contiene los parámetros de entrada para esta operación de control de energía. Este es el mismo valor que el controlador solicitante proporcionado como el parámetro InBuffer a la rutina PoFxPowerControl .

[in] InBufferSize

Tamaño en bytes del búfer al que apunta InBuffer. Este es el mismo valor que el controlador solicitante proporcionado como el parámetro InBufferSize a la rutina PoFxPowerControl .

[in] OutBuffer

Puntero a un búfer de salida asignado por el controlador al que el PEP escribe los resultados de esta operación de control de energía. Este es el mismo valor que el controlador solicitante proporcionado como el parámetro OutBuffer a la rutina PoFxPowerControl .

[in] OutBufferSize

Tamaño en bytes del búfer al que apunta OutBuffer.

[out] BytesReturned

Número de bytes a los que el PEP escribió en el búfer de salida al que apunta OutBuffer.

[out] Status

Estado de la operación de control de energía solicitada. Si la operación se realiza correctamente, el PEP establece este miembro en STATUS_SUCCESS. De lo contrario, el PEP establece este miembro en un código de estado de error adecuado.

Comentarios

La notificación de PEP_DPM_POWER_CONTROL_REQUEST usa esta estructura. Los seis primeros miembros de la estructura contienen valores de entrada proporcionados por Windows Power Management Framework (PoFx). Los dos últimos miembros contienen valores que el PEP escribe en la estructura en respuesta a esta notificación. Además, el PEP escribe en el búfer de salida al que apunta el miembro OutBuffer .

Si el búfer de salida es demasiado pequeño para recibir todos los datos de resultado de la operación, el PEP establece el miembro Status de la estructura en STATUS_INSUFFICIENT_RESOURCES, establece el miembro BytesReturned en el tamaño necesario del búfer de salida y (normalmente) no escribe datos en el búfer de salida.

El controlador de un dispositivo puede llamar a la rutina PoFxPowerControl para solicitar una operación de control de energía en el dispositivo. Durante esta llamada, PoFx delega el control de esta solicitud al PEP que posee el dispositivo. El miembro PowerControlCode de la estructura PEP_POWER_CONTROL_REQUEST contiene un código de control personalizado cuyo significado entiende tanto el controlador como el PEP para el dispositivo.

Requisitos

Requisito	Value
Cliente mínimo compatible	Se admite a partir de Windows 10.
Encabezado	pepfx.h (include Pep_x.h)

Consulte también

PEP_DPM_POWER_CONTROL_REQUEST

PEP_DPM_REGISTER_DEVICE

PoFxPowerControl