Função PoFxQueryCurrentComponentPerfState (wdm.h)

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 anteriormente esse identificador da rotina PoFxRegisterDevice .

[in] Flags

Definido 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 Componentes 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.

Valor de retorno

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.

Observações

Um driver pode chamar a rotina PoFxQueryCurrentComponentPerfState para recuperar o estado de desempenho atual de um determinado conjunto de estado de desempenho 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 de 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 de 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 .

Requirements

Consulte também

Gerenciamento de estado de desempenho do dispositivo

PO_FX_COMPONENT_PERF_INFO

PO_FX_COMPONENT_PERF_SET

PoFxRegisterComponentPerfStates