estrutura PEP_POWER_CONTROL_COMPLETE (pepfx.h)

A estrutura PEP_POWER_CONTROL_COMPLETE contém informações status para uma operação de controle de energia que o PEP solicitou anteriormente e que o driver do dispositivo concluiu.

Sintaxe

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;

Membros

[in] DeviceHandle

Um valor PEPHANDLE que identifica o dispositivo. O PEP forneceu esse identificador em resposta a uma notificação de PEP_DPM_REGISTER_DEVICE anterior.

[in] PowerControlCode

Um ponteiro para um valor GUID que especifica a operação de controle de energia que foi executada. Esse é o mesmo valor que o PEP forneceu em resposta à notificação de PEP_DPM_WORK para iniciar a operação de controle de energia.

[in] RequestContext

Um ponteiro para o contexto de solicitação que foi enviado pelo PEP na estrutura PEP_WORK_INFORMATION que o PEP forneceu na solicitação de trabalho original. Normalmente, esse membro aponta para uma estrutura que contém um ponteiro para um buffer de saída para conter os resultados da operação de controle de energia que foi solicitada pelo PEP.

[in] BytesReturned

O tamanho, em bytes, dos dados de resultado armazenados pelo driver no buffer de saída. Para obter mais informações sobre esse buffer, consulte a descrição do membro RequestContext .

[in] Status

O status da operação de controle de energia. Se a operação tiver sido bem-sucedida, o PEP definirá esse membro como STATUS_SUCCESS. Caso contrário, o PEP define esse membro como um erro apropriado status código.

Comentários

Essa estrutura é usada pela notificação de PEP_DPM_POWER_CONTROL_COMPLETE . Todos os cinco membros da estrutura contêm valores de entrada fornecidos por

Se o buffer de saída for muito pequeno para receber todos os dados de resultado da operação, o PEP definirá o membro Status da estrutura como STATUS_INSUFFICIENT_RESOURCES, definirá o membro BytesReturned para o tamanho necessário do buffer de saída e (normalmente) não gravará nenhum dado no buffer de saída.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Com suporte começando com Windows 10.
Cabeçalho	pepfx.h (inclua Pep_x.h)

Confira também

GUID