Compartilhar via


estrutura PEP_KERNEL_INFORMATION_STRUCT_V3 (pepfx.h)

A estrutura de PEP_KERNEL_INFORMATION_STRUCT_V3 especifica a interface que o PEP (plug-in de extensão de energia) usa para solicitar serviços da PoFx (estrutura de gerenciamento de energia) do Windows .

Sintaxe

typedef struct _PEP_KERNEL_INFORMATION_STRUCT_V3 {
  USHORT                                   Version;
  USHORT                                   Size;
  POHANDLE                                 Plugin;
  PPOFXCALLBACKREQUESTWORKER               RequestWorker;
  PPOFXCALLBACKENUMERATEUNMASKEDINTERRUPTS EnumerateUnmaskedInterrupts;
  PPOFXCALLBACKPROCESSORHALT               ProcessorHalt;
  PPOFXCALLBACKREQUESTINTERRUPT            RequestInterrupt;
  PPOFXCALLBACKCRITICALRESOURCE            TransitionCriticalResource;
  PPOFXCALLBACKPROCESSORIDLEVETO           ProcessorIdleVeto;
  PPOFXCALLBACKPLATFORMIDLEVETO            PlatformIdleVeto;
  PPOFXCALLBACKUPDATEPROCESSORIDLESTATE    UpdateProcessorIdleState;
  PPOFXCALLBACKUPDATEPLATFORMIDLESTATE     UpdatePlatformIdleState;
  PPOFXCALLBACKREQUESTCOMMON               RequestCommon;
} PEP_KERNEL_INFORMATION_STRUCT_V3, *PPEP_KERNEL_INFORMATION_STRUCT_V3;

Membros

Version

O número de versão atual dessa estrutura. Defina esse membro como PEP_KERNEL_INFORMATION_VERSION.

Size

O tamanho, em bytes, dessa estrutura. Defina esse membro como tamanho de(PEP_KERNEL_INFORMATION).

Plugin

O identificador atribuído ao registro do PEP com PoFx. PoFx define o valor desse membro. O PEP usa esse identificador em chamadas para a rotina de RequestWorker.

RequestWorker

Um ponteiro para uma rotina RequestWorker. PoFx define o valor desse membro. A rotina de RequestWorker é implementada pela PoFx. O PEP chama essa rotina para solicitar o uso de um thread de trabalho do sistema operacional.

EnumerateUnmaskedInterrupts

Um ponteiro para um EnumerateUnmaskedInterrupts rotina. PoFx define o valor desse membro. A rotina de EnumerateUnmaskedInterrupts é implementada pela PoFx. O PEP chama essa rotina para solicitar informações sobre as interrupções desmascaradas.

ProcessorHalt

Um ponteiro para uma rotina de ProcessorHalt. PoFx define o valor desse membro. A rotina de ProcessorHalt é implementada pela PoFx. O PEP chama essa rotina para preparar o processador atual para entrar no estado interrompido.

RequestInterrupt

Um ponteiro para uma rotina RequestInterrupt. PoFx define o valor desse membro. A rotina RequestInterrupt é implementada pela PoFx. O PEP chama essa rotina para reproduzir uma interrupção disparada por borda que pode ter sido perdida depois que a plataforma de hardware entrou em um estado de sistema de baixa potência.

TransitionCriticalResource

Um ponteiro para uma rotina TransitionCriticalResource. PoFx define o valor desse membro. A rotina TransitionCriticalResource é implementada pela PoFx. O PEP chama essa rotina para fazer a transição de recursos críticos do sistema para a condição ociosa.

ProcessorIdleVeto

Um ponteiro para uma rotina de ProcessorIdleVeto. PoFx define o valor desse membro. A rotina de ProcessorIdleVeto é implementada pela PoFx. O PEP chama essa rotina para incrementar ou diminuir a contagem de vetos para uma transição pendente para um estado ocioso do processador.

PlatformIdleVeto

Um ponteiro para uma rotina de PlatformIdleVeto. PoFx define o valor desse membro. A rotina de PlatformIdleVeto é implementada pela PoFx. O PEP chama essa rotina para incrementar ou diminuir a contagem de vetos para uma transição pendente para um estado ocioso da plataforma.

UpdateProcessorIdleState

Um ponteiro para uma rotina UpdateProcessorIdleState. PoFx define o valor desse membro. A rotina de UpdateProcessorIdleState é implementada pela PoFx. O PEP chama essa rotina para atualizar as propriedades do estado ocioso do processador especificado.

UpdatePlatformIdleState

Um ponteiro para uma rotina UpdatePlatformIdleState. PoFx define o valor desse membro. A rotina de UpdatePlatformIdleState é implementada pela PoFx. O PEP chama essa rotina para atualizar as propriedades do estado ocioso da plataforma especificado.

RequestCommon

Um ponteiro para uma rotina de RequestCommon. PoFx define o valor desse membro. A rotina de RequestCommon é implementada pela PoFx. O PEP chama essa rotina para executar uma operação de processamento especificada por uma ID de solicitação.

Observações

O parâmetro KernelInformation para a PoFxRegisterPlugin ou PoFxRegisterPluginEx é um ponteiro para uma estrutura PEP_KERNEL_INFORMATION. O PEP aloca essa estrutura e define os valores dos membros version e Size dessa estrutura antes de chamar PoFxRegisterPlugin ou PoFxRegisterPluginEx. Durante a chamada para essa rotina, a PoFx preenche os membros restantes da estrutura.

Requisitos

Requisito Valor
de cliente com suporte mínimo Com suporte a partir do Windows 10.
cabeçalho pepfx.h (inclua Pep_x.h)

Consulte também

EnumerateUnmaskedInterrupts

PlatformIdleVeto

PoFxRegisterPlugin

PoFxRegisterPluginEx

ProcessorHalt

ProcessorIdleVeto

RequestCommon

RequestInterrupt

RequestWorker

TransitionCriticalResource

UpdatePlatformIdleState

UpdateProcessorIdleState