estrutura PEP_REQUEST_COMPONENT_PERF_STATE (pepfx.h)

Artigo
02/07/2025

A estrutura PEP_REQUEST_COMPONENT_PERF_STATE contém uma lista de alterações de estado de desempenho (P-state) solicitadas pela PoFx (estrutura de gerenciamento de energia) do Windows, além de informações de status sobre o tratamento dessas solicitações pelo PEP (plug-in de extensão de plataforma).

Sintaxe

typedef struct _PEP_REQUEST_COMPONENT_PERF_STATE {
  [in]  PEPHANDLE                         DeviceHandle;
  [in]  ULONG                             Component;
  [out] BOOLEAN                           Completed;
  [out] BOOLEAN                           Succeeded;
  [in]  ULONG                             PerfRequestsCount;
  [in]  PPEP_COMPONENT_PERF_STATE_REQUEST PerfRequests;
} PEP_REQUEST_COMPONENT_PERF_STATE, *PPEP_REQUEST_COMPONENT_PERF_STATE;

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] Component

O índice que identifica o componente. Esse membro é um índice na matriz componentes na estrutura de PEP_DEVICE_REGISTER_V2 fornecida anteriormente pelo PEP em resposta à notificação de PEP_DPM_REGISTER_DEVICE deste dispositivo. Se a matriz Componentes contiver N elementos, os índices de componentes variam de 0 a N–1.

[out] Completed

Se o PEP concluiu as alterações de estado P solicitadas. Defina como TRUE para indicar que as alterações de estado P foram concluídas de forma síncrona. Defina como FALSE para indicar que as alterações de estado P solicitadas estão pendentes e serão concluídas de forma assíncrona por um thread de trabalho pep. Para obter mais informações, consulte Comentários.

[out] Succeeded

Se as alterações de estado P solicitadas foram concluídas com êxito. Defina como TRUE se o PEP tiver concluído com êxito todas as alterações de estado P solicitadas na matriz PerfRequests. Definido como FALSE se o PEP não puder executar todas as alterações de estado P solicitadas, nesse caso, os estados P no hardware ficaram inalterados. O membro bem-sucedido é usado apenas para alterações síncronas de estado P. Se o PEP definir Concluído como FALSE, o PoFx ignorará o valor no membro bem-sucedido.

[in] PerfRequestsCount

O número de alterações de estado P solicitadas na matriz apontada pelo membro PerfRequests.

[in] PerfRequests

Um ponteiro para uma matriz de estruturas PEP_COMPONENT_PERF_STATE_REQUEST. Cada elemento na matriz especifica um novo nível de desempenho a ser atribuído a um conjunto de estado P. O número de elementos de matriz é especificado pelo membro PerfRequestsCount.

Observações

Essa estrutura é usada pela notificação de PEP_DPM_REQUEST_COMPONENT_PERF_STATE. O DeviceHandle, Component, PerfRequestsCounte PerfRequests membros da estrutura contêm valores de entrada fornecidos pela PoFx quando essa notificação é enviada. Os membros Completed e Succeeded contêm valores de saída que o PEP grava na estrutura em resposta à notificação.

O PEP pode concluir as alterações de estado P solicitadas de forma síncrona ou assíncrona. O PEP pode definir o membro Concluído como TRUE para indicar que todas as solicitações na notificação de PEP_DPM_REQUEST_COMPONENT_PERF_STATE foram concluídas de forma síncrona, ou seja, antes do retorno da rotina de retorno de chamada do AcceptDeviceNot ification do PEP. Ou, o PEP pode definir concluído como FALSE para indicar que as solicitações serão concluídas de forma assíncrona. Para concluir as solicitações de forma assíncrona, o PEP deve chamar a rotina RequestWorker para informar à PoFx que o PEP tem uma solicitação de trabalho a ser enviada e a PoFx responderá enviando uma notificação PEP_DPM_WORK ao PEP.

PoFx grava as alterações de estado P solicitadas na matriz PerfRequests antes que a notificação de PEP_DPM_REQUEST_COMPONENT_PERF_STATE seja enviada. Se o PEP manipular as alterações de estado P solicitadas de forma síncrona, o conteúdo da matriz PerfRequests permanecerá válido somente até que o retorno da AcceptDeviceNotification rotina de retorno de chamada. Se as solicitações forem concluídas de forma assíncrona, o conteúdo da matriz permanecerá válido até que o PEP chame a [rotina CompleteWork para notificar a PoFx de que o PEP concluiu as solicitações pendentes.