Função de retorno de chamada POFXCALLBACKUPDATEPROCESSORIDLESTATE (pep_x.h)

Artigo
02/07/2025

A rotina UpdateProcessorIdleState é chamada pelo PEP (plug-in de extensão de plataforma) para atualizar as propriedades do estado ocioso do processador especificado.

Sintaxe

POFXCALLBACKUPDATEPROCESSORIDLESTATE Pofxcallbackupdateprocessoridlestate;

NTSTATUS Pofxcallbackupdateprocessoridlestate(
  [in] POHANDLE ProcessorHandle,
  [in] ULONG ProcessorState,
  [in] PPEP_PROCESSOR_IDLE_STATE_UPDATE Update
)
{...}

Parâmetros

[in] ProcessorHandle

Um valor POHANDLE que representa o registro do processador (como um dispositivo) com o da estrutura de gerenciamento de energia do Windows (PoFx). O PEP recebeu anteriormente esse identificador da PoFx durante a notificação PEP_DPM_REGISTER_DEVICE que informava ao PEP que o processador havia sido registrado com PoFx.

[in] ProcessorState

Um índice que identifica o estado ocioso do processador cujas propriedades devem ser atualizadas. Em resposta a uma notificação de PEP_NOTIFY_PPM_QUERY_IDLE_STATES_V2 anterior, o PEP especificou o número de estados ociosos do processador com suporte e as propriedades desses estados. Se os estados ociosos do processador N especificados pelo PEP, os índices de estado ocioso válidos do processador variam de 0 a N-1.

[in] Update

Um ponteiro para uma estrutura PEP_PROCESSOR_IDLE_STATE_UPDATE que contém as propriedades atualizadas do estado ocioso do processador.

Valor de retorno

UpdateProcessorIdleState retornará STATUS_SUCCESS se atualizar com êxito as propriedades do estado ocioso do processador. Os valores de retorno de erro possíveis incluem os seguintes códigos de status.

Valor de retorno	Descrição
STATUS_NOT_SUPPORTED	O número de versão na estrutura PEP_PROCESSOR_IDLE_STATE_UPDATE não é um valor com suporte.
STATUS_NOT_IMPLEMENTED	A rotina UpdateProcessorIdleState não é implementada para esse processador.

Observações

Essa rotina é implementada pela PoFx e é chamada pelo PEP. O UpdateProcessorIdleState da estrutura PEP_KERNEL_INFORMATION_STRUCT_V3 é um ponteiro para uma rotina de UpdateProcessorIdleState.

A rotina de UpdateProcessorIdleState deve ser chamada em IRQL = PASSIVE_LEVEL.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Com suporte a partir do Windows 10.
da Plataforma de Destino	Windows
cabeçalho	pep_x.h (inclua Pep_x.h)
IRQL	PASSIVE_LEVEL

Consulte também

PEP_DPM_REGISTER_DEVICE

PEP_KERNEL_INFORMATION_STRUCT_V3

PEP_PROCESSOR_IDLE_STATE_UPDATE

Compartilhar via