PO_FX_COMPONENT_PERF_STATE_CALLBACK función de devolución de llamada (wdm.h)

  • Artículo

La rutina de devolución de llamada ComponentPerfStateCallback notifica al controlador que su solicitud para cambiar el estado de rendimiento de un componente está completo.

Sintaxis

PO_FX_COMPONENT_PERF_STATE_CALLBACK PoFxComponentPerfStateCallback;

void PoFxComponentPerfStateCallback(
  [in] PVOID Context,
  [in] ULONG Component,
  [in] BOOLEAN Succeeded,
  [in] PVOID RequestContext
)
{...}

Parámetros

[in] Context

Puntero al contexto del dispositivo. El controlador de dispositivo usa este contexto para almacenar información sobre el estado de energía actual del dispositivo. El controlador de dispositivo especificó este puntero en el miembro DeviceContext de la estructura PO_FX_DEVICE que el controlador usó para registrar el dispositivo con el marco de administración de energía (PoFx). Este contexto es opaco para PoFx.

[in] Component

Especifica el índice que identifica el componente. 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] Succeeded

Si es TRUE, el complemento de extensión de plataforma (PEP) se realizó correctamente con el cambio de estado de rendimiento. Si es FALSE, el PEP produjo un error en el cambio de estado de rendimiento. Para obtener más información, vea la sección Comentarios.

[in] RequestContext

Puntero al contexto de dispositivo o controlador opcional especificado por el parámetro Context de la rutina PoFxIssueComponentPerfStateChange o PoFxIssueComponentPerfStateChangeMultiple .

Valor devuelto

None

Observaciones

Cuando un controlador de dispositivo solicita un cambio de estado de rendimiento llamando a la rutina PoFxIssueComponentPerfStateChange o PoFxIssueComponentPerfStateChangeMultiple , PoFx llama a la rutina ComponentPerfStateCallback para notificar al controlador cuando se completa la solicitud.

Para especificar una rutina ComponentPerfStateCallback , use el parámetro ComponentPerfStateCallback de la rutina PoFxRegisterComponentPerfStates cuando el controlador se registre para la administración del estado de rendimiento de PoFx. La rutina ComponentPerfStateCallback puede ser la misma para todos los componentes y todos los dispositivos.

Si Succeeded es TRUE, el controlador debe realizar cualquier trabajo necesario para cambiar el estado de rendimiento en el hardware. Si Succeeded es FALSE, el controlador puede optar por no hacer nada o reintentar la solicitud con el mismo estado de rendimiento o un estado de rendimiento alternativo.

Requisitos

Requisito Value
Cliente mínimo compatible Se admite a partir de Windows 10.
Plataforma de destino Escritorio
Encabezado wdm.h
IRQL Se llama en IRQL <= DISPATCH_LEVEL.

Consulte también

PoFxIssueComponentPerfStateChange

PoFxIssueComponentPerfStateChangeMultiple

PoFxRegisterDevice