PIBIO_ENGINE_NOTIFY_POWER_CHANGE_FN funzione di callback (winbio_adapter.h)
Chiamato da Windows Biometric Framework quando il computer è pronto a immettere uno stato di bassa potenza o quando il computer è stato svegliato da uno stato a bassa potenza. Lo scopo di questa funzione è consentire all'adattatore di rispondere alle transizioni nello stato di alimentazione del computer.
Sintassi
PIBIO_ENGINE_NOTIFY_POWER_CHANGE_FN PibioEngineNotifyPowerChangeFn;
HRESULT PibioEngineNotifyPowerChangeFn(
[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:
- PBT_APMSUSPEND
Il sistema sta immettendo uno stato a bassa potenza.
- PBT_APMRESUMEAUTOMATIC
Il sistema viene restituito da uno stato a bassa potenza.
- PBT_APMPOWERSTATUSCHANGE
Lo stato della fonte di alimentazione del sistema sta cambiando (ad esempio, il sistema è passato dalla batteria alla potenza linea o la batteria è bassa).
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 di codici di errore comuni, vedere Valori HRESULT comuni.
Commenti
Quando riceve un evento PBT_APMPOWERSTATUSCHANGE , l'adattatore deve chiamare l'APIGetSystemPowerStatus 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 si sta facendo.
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 |