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

Artigo
02/07/2025

O ProcessorIdleVeto incrementos rotineiros ou diminui a contagem de vetos para um código de veto para um estado ocioso do processador.

Sintaxe

POFXCALLBACKPROCESSORIDLEVETO Pofxcallbackprocessoridleveto;

NTSTATUS Pofxcallbackprocessoridleveto(
  [in] POHANDLE ProcessorHandle,
  [in] ULONG ProcessorState,
  [in] ULONG VetoReason,
  [in] BOOLEAN Increment
)
{...}

Parâmetros

[in] ProcessorHandle

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

[in] ProcessorState

O índice do estado ocioso do processador cuja contagem de vetos está sendo incrementada ou decrementada. O PEP especificou anteriormente os estados ociosos do processador com suporte em resposta a uma notificação de PEP_NOTIFY_PPM_QUERY_IDLE_STATES_V2. 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] VetoReason

Um código de veto definido por PEP que indica por que o estado ocioso do processador não pode ser inserido. O PEP especificou anteriormente os motivos de veto com suporte em resposta a uma notificação de PEP_NOTIFY_PPM_QUERY_VETO_REASONS. Se o PEP especificou motivos de veto M, os códigos de veto válidos variam de 1 a M.

[in] Increment

Seja para incrementar ou diminuir a contagem de vetos. Defina como TRUE para aumentar a contagem de vetos por esse motivo de veto ou para FALSE para diminuir a contagem.

Valor de retorno

Essa rotina não retorna um valor.

Observações

Essa rotina é implementada pela PoFx (estrutura de gerenciamento de energia) e é chamada pelo PEP (plug-in de extensão de plataforma). O ProcessorIdleVeto membro da estrutura PEP_KERNEL_INFORMATION_STRUCT_V3 é um ponteiro para uma rotina de ProcessorIdleVeto.

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)

Consulte também

PEP_KERNEL_INFORMATION_STRUCT_V3

Compartilhar via