PIBIO_STORAGE_NOTIFY_POWER_CHANGE_FN funzione di callback (winbio_adapter.h)

Articolo
03/03/2024

Chiamato da Windows Biometric Framework quando il sistema è pronto per entrare in uno stato a basso consumo o quando il sistema è stato risvegliato da uno stato a basso consumo. Lo scopo di questa funzione è consentire all'adattatore di rispondere alle transizioni nello stato di alimentazione del computer.

Sintassi

PIBIO_STORAGE_NOTIFY_POWER_CHANGE_FN PibioStorageNotifyPowerChangeFn;

HRESULT PibioStorageNotifyPowerChangeFn(
  [in, out] PWINBIO_PIPELINE Pipeline,
  [in]      ULONG PowerEventType
)
{...}

Parametri

[in, out] Pipeline

Puntatore alla struttura WINBIO_PIPELINE associata all'unità biometrica che esegue l'operazione.

[in] PowerEventType

Indica la natura della modifica. Può essere uno dei valori seguenti:

Valore	Significato
PBT_APMSUSPEND	Il sistema sta immettendo uno stato a basso consumo
PBT_APMRESUMEAUTOMATIC	Il sistema viene restituito da uno stato a basso consumo.
PBT_APMPOWERSTATUSCHANGE	Lo stato della fonte di alimentazione del sistema sta cambiando (ad esempio, il sistema è passato dalla batteria all'alimentazione linea o la batteria sta per essere scaricata).

Valore restituito

Se la funzione ha esito positivo, restituisce S_OK. Se la funzione ha esito negativo, restituisce un valore HRESULT che indica l'errore. I valori possibili includono, ma non sono limitati a, quelli indicati nella tabella seguente. Per un elenco dei codici di errore comuni, vedere Valori HRESULT comuni.

Codice restituito	Descrizione
E_POINTER	L'argomento Pipeline è NULL.
E_INVALIDARG	L'argomento PowerEventType non è uno dei valori elencati nella tabella.

Commenti

Quando riceve un evento PBT_APMPOWERSTATUSCHANGE , l'adattatore deve chiamare l'API GetSystemPowerStatus Di Microsoft Win32 per determinare il nuovo stato di alimentazione.

Il framework biometrico chiama questo punto di ingresso dell'adattatore in modo asincrono, nel contesto di un thread arbitrario. È responsabilità dell'adattatore sincronizzare l'elaborazione di questa chiamata con qualsiasi altro lavoro che può eseguire.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 8 [solo app desktop]
Server minimo supportato	Windows Server 2012 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	winbio_adapter.h

Vedi anche

GetSystemPowerStatus

PBT_APMPOWERSTATUSCHANGE

Condividi tramite