PIBIO_STORAGE_NOTIFY_POWER_CHANGE_FN Rückruffunktion (winbio_adapter.h)

Artikel
03/13/2024

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_STORAGE_NOTIFY_POWER_CHANGE_FN PibioStorageNotifyPowerChangeFn;

HRESULT PibioStorageNotifyPowerChangeFn(
  [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:

Wert	Bedeutung
PBT_APMSUSPEND	Das System geht in einen Zustand mit niedriger Leistung ein.
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 war NULL.
E_INVALIDARG	Das PowerEventType-Argument war keiner der in der Tabelle aufgeführten Werte.

Hinweise

Wenn er ein PBT_APMPOWERSTATUSCHANGE-Ereignis empfängt, sollte der Adapter die Microsoft Win32 GetSystemPowerStatus-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

Freigeben über