PIBIO_SENSOR_NOTIFY_POWER_CHANGE_FN fonction de rappel (winbio_adapter.h)

Article
08/27/2023

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é 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_SENSOR_NOTIFY_POWER_CHANGE_FN PibioSensorNotifyPowerChangeFn;

HRESULT PibioSensorNotifyPowerChangeFn(
  [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.

PBT_APMRESUMEAUTOMATIC

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

PBT_APMPOWERSTATUSCHANGE

La 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 ne faisait pas partie des valeurs répertoriées.

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

Partager via