PO_FX_COMPONENT_PERF_STATE_CALLBACK función de devolución de llamada (wdm.h)
El ComponentPerfStateCallback rutina de devolución de llamada 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 de 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 componentes de en la estructura de 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 componentes van de 0 a N-1.
[in] Succeeded
Si es TRUE, el complemento de extensión de plataforma (PEP) realizó correctamente 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 del PoFxIssueComponentPerfStateChange o PoFxIssueComponentPerfStateChangeMultiple rutina.
Valor devuelto
Ninguno
Observaciones
Cuando un controlador de dispositivo solicita un cambio de estado de rendimiento llamando a la rutina de PoFxIssueComponentPerfStateChange o PoFxIssueComponentPerfStateChangeMultiple rutina, PoFx llama a la rutina ComponentPerfStateCallback para notificar al controlador cuando se complete la solicitud.
Para especificar una rutina de ComponentPerfStateCallback, use el parámetro ComponentPerfStateCall back del PoFxRegisterComponentPerfStates rutina cuando el controlador se registre para la administración del estado de rendimiento por PoFx. La rutina ComponentPerfStateCallback puede ser la misma para todos los componentes y todos los dispositivos.
Si correcto es TRUE, el controlador debe realizar el trabajo necesario para cambiar el estado de rendimiento en el hardware. Si Correcto 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 | Valor |
|---|---|
| cliente mínimo admitido | Se admite a partir de Windows 10. |
| de la plataforma de destino de | Escritorio |
| encabezado de | wdm.h |
| irQL | Se llama a irQL <= DISPATCH_LEVEL. |
Consulte también
PoFxIssueComponentPerfStateChange