Partager via

PIBIO_ENGINE_NOTIFY_POWER_CHANGE_FN fonction de rappel (winbio_adapter.h)

  • Article

Appelé par l’infrastructure biométrique Windows lorsque l’ordinateur est prêt à entrer dans un état de faible consommation ou lorsque l’ordinateur a été réveillé à partir d’un état de faible consommation. L’objectif de cette fonction est de permettre à l’adaptateur de répondre aux transitions dans l’état d’alimentation de l’ordinateur.

Syntaxe

PIBIO_ENGINE_NOTIFY_POWER_CHANGE_FN PibioEngineNotifyPowerChangeFn;

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

Paramètres

[in, out] Pipeline

Pointeur vers la structure WINBIO_PIPELINE associée à l’unité biométrique effectuant l’opération.

[in] PowerEventType

Indique la nature de la modification. Ce peut être l’une des valeurs suivantes :

  • PBT_APMSUSPEND

Le système entre dans un état de faible consommation d’énergie.

  • PBT_APMRESUMEAUTOMATIC

Le système revient d’un état de faible consommation.

  • PBT_APMPOWERSTATUSCHANGE

Le status de la source d’alimentation du système change (par exemple, le système est passé de la batterie à l’alimentation de ligne, ou la batterie devient faible).

Valeur retournée

Si la fonction réussit, elle retourne S_OK. Si la fonction échoue, elle retourne une valeur HRESULT qui indique l’erreur. Les valeurs possibles sont notamment celles figurant dans le tableau suivant. Pour obtenir la liste des codes d’erreur courants, consultez Valeurs HRESULT courantes.

Remarques

Lorsqu’il reçoit un événement PBT_APMPOWERSTATUSCHANGE, l’adaptateur doit appeler l’API Microsoft Win32GetSystemPowerStatus pour déterminer la nouvelle status d’alimentation.

L’infrastructure biométrique appelle ce point d’entrée de l’adaptateur de manière asynchrone dans le contexte d’un thread arbitraire. Il incombe à l’adaptateur de synchroniser le traitement de cet appel avec tout autre travail qu’il peut effectuer.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 8 [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2012 [applications de bureau uniquement]
Plateforme cible Windows
En-tête winbio_adapter.h

Voir aussi

GetSystemPowerStatus

PBT_APMPOWERSTATUSCHANGE