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_IDLE_SELECT

PEP_NOTIFY_PPM_QUERY_IDLE_STATES

PEP_PROCESSOR_IDLE_CONSTRAINTS

PEP_PROCESSOR_IDLE_DEPENDENCY