estrutura PEP_PPM_IDLE_SELECT (pep_x.h)
A estrutura PEP_PPM_IDLE_SELECT descreve o estado ocioso mais eficiente em termos de energia que o processador pode inserir e ainda atender às restrições especificadas pelo sistema operacional.
Sintaxe
typedef struct _PEP_PPM_IDLE_SELECT {
[in] PPEP_PROCESSOR_IDLE_CONSTRAINTS Constraints;
[out] BOOLEAN AbortTransition;
[out] ULONG IdleStateIndex;
[out] ULONG DependencyArrayUsed;
[in] ULONG DependencyArrayCount;
[in] PPEP_PROCESSOR_IDLE_DEPENDENCY DependencyArray;
[out] ULONG PlatformIdleStateIndex;
} PEP_PPM_IDLE_SELECT, *PPEP_PPM_IDLE_SELECT;
Membros
[in] Constraints
Um ponteiro para uma estrutura PEP_PROCESSOR_IDLE_CONSTRAINTS que especifica as restrições que o estado ocioso do processador selecionado deve atender. O sistema operacional define os valores nessa estrutura. O PEP (plug-in de extensão de plataforma) deve selecionar um estado ocioso do processador que atenda a essas restrições.
[out] AbortTransition
Se deseja cancelar a transição pendente para um estado ocioso do processador. Defina esse membro como TRUE se o PEP exigir que o sistema operacional cancele a transição pendente e, caso contrário, false. O PEP seleciona essa opção se quiser enfileirar o trabalho e fazer com que o kernel do Windows processe esse trabalho antes que o processador entre ocioso.
[out] IdleStateIndex
O índice que identifica o estado ocioso que o processador deve inserir. Esse membro será ignorado se AbortTransition = TRUE. Se o processador der suporte a N estados ociosos, os índices de estado ocioso variam de 0 a N–1. O PEP forneceu o número de estados ociosos com suporte para esse processador em resposta a uma notificação de PEP_NOTIFY_PPM_QUERY_IDLE_STATES anterior.
[out] DependencyArrayUsed
O número de elementos de matriz que o PEP realmente gravou no buffer de saída apontou para o membro DependencyArray .
[in] DependencyArrayCount
O número máximo de elementos na matriz apontada pelo membro DependencyArray . O valor do membro DependencyArrayCount é igual ao valor MaximumCoordinatedProcessors que o PEP forneceu anteriormente em resposta à notificação de PEP_NOTIFY_PPM_QUERY_IDLE_STATES .
[in] DependencyArray
Um ponteiro para um buffer de saída no qual o PEP grava uma matriz de estruturas PEP_PROCESSOR_IDLE_DEPENDENCY . Os elementos dessa matriz especificam dependências ociosas do processador ou dependências de ativação que devem ser atendidas para que essa transição ociosa tenha êxito. O PEP define o membro DependencyArrayUsed como o número real de elementos de matriz que o PEP grava no buffer. O buffer de saída é alocado pela PoFx ( estrutura de gerenciamento de energia ) do Windows e tem a garantia de ser grande o suficiente para conter o número de elementos de matriz especificados pelo membro DependencyArrayCount .
[out] PlatformIdleStateIndex
O índice do estado ocioso da plataforma que a plataforma deve inserir quando o processador entra no estado ocioso do processador selecionado. O PEP deve definir esse membro somente se a plataforma inserir um estado ocioso ao mesmo tempo que o processador. Esse membro será ignorado se AbortTransition for TRUE.
Comentários
Essa estrutura é usada pela notificação de PEP_NOTIFY_PPM_IDLE_SELECT . Os membros Constraints, DependencyArrayCount e DependencyArray da estrutura contêm valores de entrada fornecidos pelo PoFx quando essa notificação é enviada. Os membros restantes contêm valores de saída que o PEP grava na estrutura em resposta à notificação.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Com suporte começando com Windows 10. |
| Cabeçalho | pep_x.h (inclua Pepfx.h) |
Confira também
PEP_NOTIFY_PPM_QUERY_IDLE_STATES