PIBIO_SENSOR_NOTIFY_POWER_CHANGE_FN Rückruffunktion (winbio_adapter.h)

  • Artikel

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
E_POINTER
 Das Pipelineargument lautet NULL.
E_INVALIDARG
 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