PIBIO_STORAGE_NOTIFY_POWER_CHANGE_FN fonction de rappel (winbio_adapter.h)

Article
03/06/2024

Appelé par l’infrastructure biométrique Windows lorsque le système est prêt à entrer dans un état de faible consommation ou lorsque le système 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_STORAGE_NOTIFY_POWER_CHANGE_FN PibioStorageNotifyPowerChangeFn;

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

Valeur	Signification
PBT_APMSUSPEND	Le système entre dans un état de faible consommation
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.

Code de retour	Description
E_POINTER	L’argument Pipeline était NULL.
E_INVALIDARG	L’argument PowerEventType n’était pas l’une des valeurs répertoriées dans la table.

Remarques

Lorsqu’il reçoit un événement PBT_APMPOWERSTATUSCHANGE, l’adaptateur doit appeler l’API Microsoft Win32 GetSystemPowerStatus 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

Partager via