estrutura PEP_PPM_QUERY_DOMAIN_INFO (pepfx.h)

  • Artigo

Usado na notificação PEP_NOTIFY_PPM_QUERY_DOMAIN_INFO que consulta informações sobre um domínio de desempenho.

Sintaxe

typedef struct _PEP_PPM_QUERY_DOMAIN_INFO {
  ULONG   DomainId;
  UCHAR   CoordinationType;
  BOOLEAN IdleProcessorsDiscounted;
  BOOLEAN SchedulerDirectedTransitionsSupported;
  BOOLEAN AffinitizePerfSet;
  ULONG   WorstCaseTransitionLatency;
  ULONG   WorstCaseTransitionOverhead;
} PEP_PPM_QUERY_DOMAIN_INFO, *PPEP_PPM_QUERY_DOMAIN_INFO;

Membros

DomainId

Na entrada, a ID de domínio do domínio que está sendo consultado.

CoordinationType

Na saída, indica o tipo de coordenação do domínio de desempenho. Os valores possíveis são:

  • PROCESSOR_DOMAIN_COORDIANTION_SW_ALL (0x00)
  • PROCESSOR_DOMAIN_COORDIANTION_SW_ANY (0x01)
  • PROCESSOR_DOMAIN_COORDIANTION_HW_ALL (0x02)
Se não houver suporte para essa notificação, PROCESSOR_DOMAIN_COORDIANTION_SW_ALL coordenação será usada.

IdleProcessorsDiscounted

Na saída e se a coordenação HW-ALL for usada, esse valor será TRUE se a plataforma ignorar automaticamente as solicitações de processadores ociosos, pois determinará o nível de desempenho resolvido do domínio, FALSE se as solicitações de processadores ociosos continuarem a ser respeitadas.   Se PROCESSOR_DOMAIN_COORDIANTION_HW_ALL coordenação não for usada: esse campo será ignorado.

SchedulerDirectedTransitionsSupported

Na saída, esse valor será TRUE se o PEP der suporte aos requisitos de transições de desempenho direcionadas pelo agendador para esse domínio; caso contrário, FALSE.

AffinitizePerfSet

Na saída, esse valor será TRUE se o PEP exigir que a notificação PEP_NOTIFY_PPM_PERF_SET ou PEP_NOTIFY_PPM_PERF_SET_STATE seja executada na frequência de alteração do processador ou FALSE se o PEP permitir que essas notificações sejam executadas em qualquer processador. Se PROCESSOR_DOMAIN_COORDIANTION_SW_ANY coordenação for usada: a notificação de PEP_NOTIFY_PPM_PERF_SET ou PEP_NOTIFY_PPM_PERF_SET_STATE será executada em um processador no domínio.

WorstCaseTransitionLatency

Na saída, esse valor indica a pior latência de caso para o processador fazer a transição para um novo estado de desempenho, medido a partir do momento em que o sistema operacional emite a notificação para o PEP para fazer a transição para um novo nível de desempenho, até o momento em que o processador está em execução no novo nível de desempenho, em unidades de 100ns.

WorstCaseTransitionOverhead

Na saída, esse valor indica a pior sobrecarga de caso (tempo de execução do código PEP mais o tempo em que o processador não está executando instruções) medida desde o momento em que o sistema operacional emite a notificação para o PEP para fazer a transição para um novo nível de desempenho, até o momento em que o processador está em execução no novo nível de desempenho, em unidades de 100ns.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 10, versão 1709
Servidor mínimo com suporte Windows Server 2016
Cabeçalho pepfx.h (inclua Pep_x.h)

Confira também

Notificações de PPM (gerenciamento de energia do processador)