PIBIO_ENGINE_NOTIFY_POWER_CHANGE_FN Rückruffunktion (winbio_adapter.h)

  • Artikel

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

Weitere Informationen

GetSystemPowerStatus

PBT_APMPOWERSTATUSCHANGE