PIBIO_ENGINE_NOTIFY_POWER_CHANGE_FN Rückruffunktion (winbio_adapter.h)
Wird vom Windows-Biometrischen Framework aufgerufen, wenn der Computer bereit ist, in einen Energiesparmodus zu wechseln oder wenn der Computer aus einem Energiesparzustand aktiviert wurde. Der Zweck dieser Funktion besteht darin, dem Adapter zu ermöglichen, auf Übergänge im Energiezustand des Computers zu reagieren.
Syntax
PIBIO_ENGINE_NOTIFY_POWER_CHANGE_FN PibioEngineNotifyPowerChangeFn;
HRESULT PibioEngineNotifyPowerChangeFn(
[in, out] PWINBIO_PIPELINE Pipeline,
[in] ULONG PowerEventType
)
{...}
Parameter
[in, out] Pipeline
Zeiger auf die WINBIO_PIPELINE Struktur, die der biometrischen Einheit zugeordnet ist, die den Vorgang ausführt.
[in] PowerEventType
Gibt die Art der Änderung an. Es kann sich um einen der folgenden Werte handeln:
- PBT_APMSUSPEND
Das System wechselt in einen Low-Power-Zustand.
- PBT_APMRESUMEAUTOMATIC
Das System kehrt aus einem Low-Power-Zustand zurück.
- PBT_APMPOWERSTATUSCHANGE
Die status der Stromquelle des Systems ändert sich (z. B. hat das System von Batterie zu Leitungsstrom gewechselt, oder der Akku wird knapp).
Rückgabewert
Wenn die Funktion erfolgreich ist, wird S_OK zurückgegeben. Wenn die Funktion fehlschlägt, wird ein HRESULT-Wert zurückgegeben, der den Fehler angibt. Mögliches Werte (aber nicht die Einzigen) sind die in der folgenden Tabelle. Eine Liste allgemeiner Fehlercodes finden Sie unter Allgemeine HRESULT-Werte.
Hinweise
Wenn er ein PBT_APMPOWERSTATUSCHANGE-Ereignis empfängt, sollte der Adapter die Microsoft Win32GetSystemPowerStatus-API aufrufen, um die neue Power status zu ermitteln.
Das biometrische Framework ruft diesen Adaptereinstiegspunkt asynchron im Kontext eines beliebigen Threads auf. Es liegt in der Verantwortung des Adapters, die Verarbeitung dieses Aufrufs mit allen anderen Aufgaben zu synchronisieren, die er möglicherweise ausführt.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 8 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2012 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | winbio_adapter.h |