PIBIO_SENSOR_NOTIFY_POWER_CHANGE_FN funzione di callback (winbio_adapter.h)

Chiamato da Windows Biometric Framework quando il sistema è pronto a immettere uno stato di bassa potenza o quando il sistema è stato risvegliato 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_SENSOR_NOTIFY_POWER_CHANGE_FN PibioSensorNotifyPowerChangeFn;

HRESULT PibioSensorNotifyPowerChangeFn(
  [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 può essere eseguito.

Requisiti