estrutura PEP_REQUEST_COMPONENT_PERF_STATE (pep_x.h)

Artigo
08/07/2023

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 status informações 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 Components na estrutura PEP_DEVICE_REGISTER_V2 que o PEP forneceu anteriormente em resposta à notificação de PEP_DPM_REGISTER_DEVICE para este dispositivo. Se a matriz Components 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 . Defina 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 Succeeded é usado apenas para alterações síncronas de estado P. Se o PEP definir Concluído como FALSE, PoFx ignorará o valor no membro Êxito .

[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 .

Comentários

Essa estrutura é usada pela notificação PEP_DPM_REQUEST_COMPONENT_PERF_STATE . Os membros DeviceHandle, Component, PerfRequestsCount e PerfRequests 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 Completed como TRUE para indicar que todas as solicitações no PEP_DPM_REQUEST_COMPONENT_PERF_STATE notificação foram concluídas de forma síncrona, ou seja, antes do retorno da rotina de retorno de chamada AcceptDeviceNotification 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 para enviar e a PoFx responderá enviando uma notificação de PEP_DPM_WORK para o PEP.

O 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é o retorno da rotina de retorno de chamada AcceptDeviceNotification . 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.