Función PoFxSetComponentWake (wdm.h)

La rutina PoFxSetComponentWake indica si el controlador activa el componente especificado cada vez que el componente entra en la condición de inactividad.

Sintaxis

void PoFxSetComponentWake(
  [in] POHANDLE Handle,
  [in] ULONG    Component,
  [in] BOOLEAN  WakeHint
);

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ó anteriormente este identificador de la rutina PoFxRegisterDevice .

[in] Component

Í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 oscilan entre 0 y N-1.

[in] WakeHint

Si el controlador controla el componente que se reactiva cada vez que el componente entra en la condición de inactividad. Si es TRUE, el controlador arma el componente que se va a reactivar. Si es FALSE, el controlador no armó el componente para reactivarse.

Valor devuelto

None

Observaciones

Antes de que un componente entre en un estado Fx de baja potencia, el controlador podría armar el componente para reactivar automáticamente en respuesta a una señal de entrada de un origen externo (por ejemplo, si el usuario presiona un botón). El parámetro WakeHint informa a PoFx si el controlador controla el componente que se va a reactivar. Si un componente está armado para reactivarse, PoFx no cambiará el componente a un estado Fx de bajo consumo desde el que el componente no se puede activar.

Cuando un dispositivo se registra con PoFx, la información de registro de cada componente del dispositivo se incluye en una estructura de PO_FX_COMPONENT independiente. El miembro De más profundoWakeableIdleState de esta estructura especifica el estado fx más profundo desde el que el componente puede reactivar.

El controlador de dispositivo puede llamar a PoFxSetComponentWake cada vez que un cambio en las condiciones requiere un cambio en el valor wakeHint . Después de cada llamada, el nuevo valor WakeHint permanece en vigor hasta que el controlador llame a PoFxSetComponentWake de nuevo para actualizarlo.

Si un componente está en la condición de inactividad cuando se llama a PoFxSetComponentWake , PoFx podría cambiar el estado Fx del componente para dar cabida al nuevo valor del parámetro WakeHint especificado por el autor de la llamada.

Requisitos

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

Consulte también

PO_FX_COMPONENT