Share via

PIBIO_SENSOR_NOTIFY_POWER_CHANGE_FN función de devolución de llamada (winbio_adapter.h)

  • Artículo

Lo llama el marco biométrico de Windows cuando el sistema está listo para entrar en un estado de bajo consumo o cuando el sistema 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_SENSOR_NOTIFY_POWER_CHANGE_FN PibioSensorNotifyPowerChangeFn;

HRESULT PibioSensorNotifyPowerChangeFn(
  [in, out] PWINBIO_PIPELINE Pipeline,
  [in]      ULONG PowerEventType
)
{...}

Parámetros

[in, out] Pipeline

Puntero a la estructura de 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.

Código devuelto Descripción
E_POINTER
 El argumento Pipeline era NULL
E_INVALIDARG
 El argumento PowerEventType no era uno de los valores enumerados.

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 estar haciendo.

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