estrutura PEP_KERNEL_INFORMATION_STRUCT_V3 (pepfx.h)

Artigo
08/07/2023

A estrutura 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 sizeof(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 RequestWorker .

RequestWorker

Um ponteiro para uma rotina RequestWorker . PoFx define o valor desse membro. A rotina 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 uma rotina EnumerateUnmaskedInterrupts . PoFx define o valor desse membro. A rotina EnumerateUnmaskedInterrupts é implementada pela PoFx. O PEP chama essa rotina para solicitar informações sobre as interrupções desmascaradas.

ProcessorHalt

Um ponteiro para uma rotina ProcessorHalt . PoFx define o valor desse membro. A rotina 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 ProcessorIdleVeto . PoFx define o valor desse membro. A rotina 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 PlatformIdleVeto . PoFx define o valor desse membro. A rotina 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 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 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 RequestCommon . PoFx define o valor desse membro. A rotina RequestCommon é implementada pela PoFx. O PEP chama essa rotina para executar uma operação de processamento especificada por uma ID de solicitação.

Comentários

O parâmetro KernelInformation para a rotina 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, PoFx preenche os membros restantes da estrutura.