Função PoFxQueryCurrentComponentPerfState (wdm.h)

  • Artigo

A rotina PoFxQueryCurrentComponentPerfState recupera o estado de desempenho ativo no conjunto de estado de desempenho de um componente.

Sintaxe

NTSTATUS PoFxQueryCurrentComponentPerfState(
  [in] POHANDLE   Handle,
  [in] ULONG      Flags,
  [in] ULONG      Component,
  [in] ULONG      SetIndex,
  [in] PULONGLONG CurrentPerf
);

Parâmetros

[in] Handle

Um identificador que representa o registro do dispositivo com a PoFx (estrutura de gerenciamento de energia). O driver do dispositivo recebeu esse identificador anteriormente da rotina PoFxRegisterDevice .

[in] Flags

Defina como 0. Atualmente, nenhum sinalizador é definido para essa rotina.

[in] Component

O índice que identifica o componente cujo estado de desempenho está sendo recuperado. Esse parâmetro é um índice na matriz Components na estrutura PO_FX_DEVICE que o driver de dispositivo usou para registrar o dispositivo com PoFx. Se a matriz Componentes contiver N elementos, os índices de componentes variam de 0 a N-1.

[in] SetIndex

O índice que identifica o conjunto de estado de desempenho cujo desempenho está sendo consultado. Esse parâmetro é um índice na matriz PerfStateSets na estrutura PO_FX_COMPONENT_PERF_INFO que o driver de dispositivo usou para registrar os estados de desempenho do componente com PoFx. Se a matriz PerfStateSets contiver N elementos, os índices de conjunto de estado de desempenho variam de 0 a N-1.

[in] CurrentPerf

Um ponteiro para a variável na qual o estado de desempenho atual do conjunto de estado de desempenho especificado é retornado. Para obter mais informações sobre o valor retornado, consulte Comentários.

Retornar valor

PoFxQueryCurrentComponentPerfState retornará STATUS_SUCCESS se a operação solicitada for bem-sucedida. Os valores de retorno de erro possíveis incluem os seguintes códigos de status.

Código de retorno Descrição
STATUS_INVALID_PARAMETER
 O chamador forneceu um índice inválido para o componente ou conjunto de estado do componente.

Comentários

Um driver pode chamar a rotina PoFxQueryCurrentComponentPerfState para recuperar o estado de desempenho atual de um determinado estado de desempenho definido para um componente. Se a chamada for bem-sucedida, o parâmetro CurrentPerf será substituído com um ponteiro para um valor que especifica o estado de desempenho atual do conjunto. Esse valor pode ser um dos seguintes, dependendo do conteúdo da estrutura PO_FX_COMPONENT_PERF_SET que o driver passou para a rotina PoFxRegisterComponentPerfStates :

  • Para um conjunto de estado de desempenho que representa uma distribuição contínua dos estados de desempenho, esse é um valor entre os membros Mínimo e Máximo da estrutura PO_FX_COMPONENT_PERF_SET .
  • Para um conjunto de estado de desempenho que representa um número discreto de estados de desempenho, esse valor é um índice para o membro Estados da estrutura PO_FX_COMPONENT_PERF_SET .
Essa chamada sempre é executada de forma síncrona.

Requisitos

Requisito Valor
Cliente mínimo com suporte Disponível a partir do Windows 10.
Plataforma de Destino Universal
Cabeçalho wdm.h
Biblioteca Ntoskrnl.lib
DLL Ntoskrnl.exe
IRQL <= DISPATCH_LEVEL

Confira também

Gerenciamento de Estado de Desempenho do Dispositivo

PO_FX_COMPONENT_PERF_INFO

PO_FX_COMPONENT_PERF_SET

PoFxRegisterComponentPerfStates