PIBIO_ENGINE_NOTIFY_POWER_CHANGE_FN fonction de rappel (winbio_adapter.h)
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 |