PIBIO_SENSOR_NOTIFY_POWER_CHANGE_FN Rückruffunktion (winbio_adapter.h)
Wird vom Biometrischen Windows-Framework aufgerufen, wenn das System bereit ist, in einen Zustand mit geringer Leistung zu wechseln oder wenn das System aus einem Zustand mit geringer Leistung geweckt wurde. Der Zweck dieser Funktion besteht darin, dem Adapter zu ermöglichen, auf Übergänge im Energiezustand des Computers zu reagieren.
Syntax
PIBIO_SENSOR_NOTIFY_POWER_CHANGE_FN PibioSensorNotifyPowerChangeFn;
HRESULT PibioSensorNotifyPowerChangeFn(
[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 Energiesparzustand.
- PBT_APMRESUMEAUTOMATIC
Das System kehrt aus einem Zustand mit geringer Leistung 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 niedrig).
Rückgabewert
Wenn die Funktion erfolgreich ist, gibt sie S_OK zurück. Wenn die Funktion fehlschlägt, gibt sie einen HRESULT-Wert zurück, 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.
Rückgabecode | Beschreibung |
---|---|
|
Das Pipelineargument lautet NULL. |
|
Das PowerEventType-Argument war keiner der aufgeführten 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 |