Compartir a través de

PIBIO_STORAGE_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 baja potencia 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_STORAGE_NOTIFY_POWER_CHANGE_FN PibioStorageNotifyPowerChangeFn;

HRESULT PibioStorageNotifyPowerChangeFn(
  [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:

Valor Significado
PBT_APMSUSPEND
 El sistema entra en un estado de baja potencia.
PBT_APMRESUMEAUTOMATIC
 El sistema vuelve de un estado de baja potencia.
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 ejecuta 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 en la tabla.

Comentarios

Cuando recibe un evento de PBT_APMPOWERSTATUSCHANGE , el adaptador debe llamar a la 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 realizando.

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

Consulte también

GetSystemPowerStatus

PBT_APMPOWERSTATUSCHANGE