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

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

Sintaxe

POFXCALLBACKUPDATEPLATFORMIDLESTATE Pofxcallbackupdateplatformidlestate;

NTSTATUS Pofxcallbackupdateplatformidlestate(
  [in] POHANDLE ProcessorHandle,
  [in] ULONG PlatformState,
  [in] PPEP_PLATFORM_IDLE_STATE_UPDATE Update
)
{...}

Parâmetros

[in] ProcessorHandle

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

[in] PlatformState

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

[in] Update

Um ponteiro para uma estrutura PEP_PLATFORM_IDLE_STATE_UPDATE que contém as propriedades atualizadas do estado ocioso da plataforma.

Retornar valor

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

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

Comentários

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

O PEP deve aguardar até que tenha concluído todas as notificações PEP_NOTIFY_PPM_QUERY_PLATFORM_STATE para chamar a rotina UpdatePlatformIdleState .

A rotina UpdatePlatformIdleState deve ser chamada em IRQL = PASSIVE_LEVEL.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Com suporte começando com Windows 10.
Plataforma de Destino	Windows
Cabeçalho	pep_x.h (inclua Pep_x.h)
IRQL	PASSIVE_LEVEL

Confira também

PEP_DPM_REGISTER_DEVICE

PEP_KERNEL_INFORMATION_STRUCT_V3

PEP_NOTIFY_PPM_QUERY_PLATFORM_STATE

PEP_NOTIFY_PPM_QUERY_PLATFORM_STATES

PEP_PLATFORM_IDLE_STATE_UPDATE