Função de retorno de chamada POFXCALLBACKUPDATEPLATFORMIDLESTATE (pepfx.h)
A rotina UpdatePlatformIdleState é chamada pelo PEP (plug-in de extensão da 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 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] 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.
Valor de retorno
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 de retorno | Descrição |
|---|---|
|
O número de versão na estrutura PEP_PLATFORM_IDLE_STATE_UPDATE não é um valor com suporte. |
|
A rotina UpdatePlatformIdleState não é implementada para este processador. |
Observações
Essa rotina é implementada pela PoFx e é chamada pelo PEP. O UpdatePlatformIdleState membro 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 de UpdatePlatformIdleState 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 | pepfx.h (inclua Pep_x.h) |
| IRQL | PASSIVE_LEVEL |
Consulte também
PEP_KERNEL_INFORMATION_STRUCT_V3
PEP_NOTIFY_PPM_QUERY_PLATFORM_STATE