Función PoFxQueryCurrentComponentPerfState (wdm.h)

La rutina PoFxQueryCurrentComponentPerfState recupera el estado de rendimiento activo en el conjunto de estados de rendimiento de un componente.

Syntax

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

Parámetros

[in] Handle

Identificador que representa el registro del dispositivo con el marco de administración de energía (PoFx). El controlador de dispositivo recibió previamente este identificador de la rutina PoFxRegisterDevice .

[in] Flags

Establezca en 0. Actualmente, no se definen marcas para esta rutina.

[in] Component

Índice que identifica el componente cuyo estado de rendimiento se está recuperando. Este parámetro es un índice en la matriz Components de la estructura PO_FX_DEVICE que el controlador de dispositivo usó para registrar el dispositivo con PoFx. Si la matriz Components contiene N elementos, los índices de componente oscilan entre 0 y N-1.

[in] SetIndex

Índice que identifica el conjunto de estados de rendimiento cuyo rendimiento se está consultando. Este parámetro es un índice en la matriz PerfStateSets de la estructura PO_FX_COMPONENT_PERF_INFO que el controlador de dispositivo usó para registrar los estados de rendimiento del componente con PoFx. Si la matriz PerfStateSets contiene N elementos, los índices del conjunto de estado de rendimiento oscilan entre 0 y N-1.

[in] CurrentPerf

Puntero a variable en la que se devuelve el estado de rendimiento actual del conjunto de estados de rendimiento especificado. Para obtener más información sobre el valor que se devuelve, vea Comentarios.

Valor devuelto

PoFxQueryCurrentComponentPerfState devuelve STATUS_SUCCESS si la operación solicitada se realiza correctamente. Entre los posibles valores devueltos de error se incluyen los siguientes códigos de estado.

Observaciones

Un controlador puede llamar a la rutina PoFxQueryCurrentComponentPerfState para recuperar el estado de rendimiento actual de un determinado conjunto de estados de rendimiento para un componente. Si la llamada se realiza correctamente, el parámetro CurrentPerf se sobrescribe con un puntero a un valor que especifica el estado de rendimiento actual del conjunto. Este valor puede ser uno de los siguientes, dependiendo del contenido de la estructura de PO_FX_COMPONENT_PERF_SET que el controlador pasó a la rutina PoFxRegisterComponentPerfStates :

• Para un conjunto de estados de rendimiento que representa una distribución continua de estados de rendimiento, se trata de un valor entre los miembros Minimum y Maximum de la estructura PO_FX_COMPONENT_PERF_SET .
• Para un conjunto de estados de rendimiento que representa un número discreto de estados de rendimiento, este valor es un índice en el miembro States de la estructura PO_FX_COMPONENT_PERF_SET .

Requisitos

Consulte también

Administración del estado de rendimiento del dispositivo

PO_FX_COMPONENT_PERF_INFO

PO_FX_COMPONENT_PERF_SET

PoFxRegisterComponentPerfStates