estrutura PEP_POWER_CONTROL_COMPLETE (pepfx.h)

Artigo
02/07/2025

A estrutura PEP_POWER_CONTROL_COMPLETE contém informações de status para uma operação de controle de energia solicitada anteriormente pelo PEP e que o driver do dispositivo foi concluído.

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 fornecido pelo PEP 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 de PEP_WORK_INFORMATION fornecida pelo PEP 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 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 definirá esse membro como um código de status de erro apropriado.

Observações

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 Status membro 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
de cliente com suporte mínimo	Com suporte a partir do Windows 10.
cabeçalho	pepfx.h (inclua Pep_x.h)

Consulte também

GUID

Compartilhar via