estructura de PEP_POWER_CONTROL_COMPLETE (pep_x.h)

La estructura de PEP_POWER_CONTROL_COMPLETE contiene información de estado para una operación de control de energía que el PEP solicitó anteriormente y que el controlador del dispositivo se ha completado.

Sintaxis

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;

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 realizó. Este es el mismo valor que el PEP proporcionado en respuesta a la notificación PEP_DPM_WORK para iniciar la operación de control de energía.

[in] RequestContext

Puntero al contexto de solicitud enviado por el PEP en la estructura de PEP_WORK_INFORMATION que el PEP proporcionó en la solicitud de trabajo original. Normalmente, este miembro apunta a una estructura que contiene un puntero a un búfer de salida para contener los resultados de la operación de control de energía solicitada por el PEP.

[in] BytesReturned

Tamaño, en bytes, de los datos de resultado almacenados por el controlador en el búfer de salida. Para obtener más información sobre este búfer, vea la descripción del miembro RequestContext .

[in] Status

Estado de la operación de control de energía. Si la operación se realizó 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_COMPLETE usa esta estructura. Los cinco miembros de la estructura contienen valores de entrada proporcionados por

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.

Requisitos

Consulte también

GUID