estructura de PEP_POWER_CONTROL_REQUEST (pep_x.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 en el 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 que escribió el PEP 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 resultados 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 se entiende tanto por el controlador como por el PEP del dispositivo.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Se admite a partir de Windows 10. |
| Encabezado | pep_x.h (incluya Pep_x.h) |