estrutura PEP_WORK_POWER_CONTROL (pepfx.h)

Artigo
03/01/2024

A estrutura PEP_WORK_POWER_CONTROL contém os parâmetros para uma solicitação de controle de energia que o PEP (plug-in de extensão de plataforma) envia diretamente para um driver de processador.

Sintaxe

typedef struct _PEP_WORK_POWER_CONTROL {
       POHANDLE DeviceHandle;
  [in] LPCGUID  PowerControlCode;
       PVOID    RequestContext;
  [in] PVOID    InBuffer;
  [in] SIZE_T   InBufferSize;
  [in] PVOID    OutBuffer;
  [in] SIZE_T   OutBufferSize;
} PEP_WORK_POWER_CONTROL, *PPEP_WORK_POWER_CONTROL;

Membros

DeviceHandle

Um valor POHANDLE que identifica o processador. O PEP recebeu esse identificador em 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 a ser executada.

RequestContext

Um ponteiro para um valor de contexto definido por PEP. O PEP pode usar esse valor para identificar exclusivamente uma mensagem de solicitação de controle de energia (caso o PEP emita várias solicitações com o mesmo código de controle para o mesmo dispositivo).

[in] InBuffer

Um ponteiro para um buffer de entrada alocado pelo driver que contém os parâmetros de entrada para essa operação de controle de energia.

[in] InBufferSize

O tamanho em bytes do buffer apontado pelo InBuffer.

[in] OutBuffer

Um ponteiro para um buffer de saída alocado por driver no qual o PEP grava os resultados dessa operação de controle de energia.

[in] OutBufferSize

O tamanho em bytes do buffer apontado pelo OutBuffer.

Comentários

O membro PowerControl da estrutura PEP_WORK_INFORMATION é um ponteiro para uma estrutura PEP_WORK_POWER_CONTROL .

O PEP emite uma solicitação de controle de energia de um thread de trabalho. A PoFx ( estrutura de gerenciamento de energia ) do Windows encaminha essa solicitação chamando a rotina PowerControlCallback do driver do processador, se o driver implementar essa rotina.