PIBIO_ENGINE_NOTIFY_POWER_CHANGE_FN función de devolución de llamada (winbio_adapter.h)
Lo llama el marco biométrico de Windows cuando el equipo está listo para entrar en un estado de bajo consumo o cuando el equipo se ha despertado de un estado de bajo consumo. El propósito de esta función es permitir que el adaptador responda a las transiciones en estado de alimentación del equipo.
Sintaxis
PIBIO_ENGINE_NOTIFY_POWER_CHANGE_FN PibioEngineNotifyPowerChangeFn;
HRESULT PibioEngineNotifyPowerChangeFn(
[in, out] PWINBIO_PIPELINE Pipeline,
[in] ULONG PowerEventType
)
{...}
Parámetros
[in, out] Pipeline
Puntero a la estructura WINBIO_PIPELINE asociada a la unidad biométrica que realiza la operación.
[in] PowerEventType
Indica la naturaleza del cambio. Puede ser uno de los siguientes valores:
- PBT_APMSUSPEND
El sistema entra en un estado de baja potencia.
- PBT_APMRESUMEAUTOMATIC
El sistema vuelve de un estado de bajo consumo.
- PBT_APMPOWERSTATUSCHANGE
El estado de la fuente de alimentación del sistema está cambiando (por ejemplo, el sistema ha cambiado de batería a energía de línea o la batería está bajando).
Valor devuelto
Si la función se realiza correctamente, devuelve S_OK. Si se produce un error en la función, devuelve un valor HRESULT que indica el error. Entre los valores posibles se incluyen los que se indican en la tabla siguiente, entre otros. Para obtener una lista de códigos de error comunes, consulte Valores HRESULT comunes.
Comentarios
Cuando recibe un evento de PBT_APMPOWERSTATUSCHANGE , el adaptador debe llamar ala API GetSystemPowerStatus de Microsoft Win32 para determinar el nuevo estado de energía.
El marco biométrico llama a este punto de entrada del adaptador de forma asincrónica en el contexto de un subproceso arbitrario. Es responsabilidad del adaptador sincronizar el procesamiento de esta llamada con cualquier otro trabajo que pueda realizar.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 8 [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2012 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | winbio_adapter.h |