Función PoFxQueryCurrentComponentPerfState (wdm.h)

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

Sintaxis

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

Establecer 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 van de 0 a 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 estados 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.

Código devuelto	Descripción
STATUS_INVALID_PARAMETER	El autor de la llamada proporcionó un índice no válido para el conjunto de estados de componente o componente.

Comentarios

Un controlador puede llamar a la rutina PoFxQueryCurrentComponentPerfState para recuperar el estado de rendimiento actual de un conjunto de estados de rendimiento determinado 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, según el 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 Mínimo y Máximo 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 .

Esta llamada siempre se ejecuta de forma sincrónica.

Requisitos

Requisito	Value
Cliente mínimo compatible	Disponible a partir de Windows 10.
Plataforma de destino	Universal
Encabezado	wdm.h
Library	Ntoskrnl.lib
Archivo DLL	Ntoskrnl.exe
IRQL	<= DISPATCH_LEVEL

Consulte también

Administración del estado de rendimiento del dispositivo

PO_FX_COMPONENT_PERF_INFO

PO_FX_COMPONENT_PERF_SET

PoFxRegisterComponentPerfStates