PIBIO_ENGINE_NOTIFY_POWER_CHANGE_FN função de retorno de chamada (winbio_adapter.h)

  • Artigo

Chamado pela Estrutura Biométrica do Windows quando o computador estiver pronto para entrar em um estado de baixa potência ou quando o computador tiver sido despertado de um estado de baixa potência. A finalidade dessa função é permitir que o adaptador responda a transições no estado de energia do computador.

Sintaxe

PIBIO_ENGINE_NOTIFY_POWER_CHANGE_FN PibioEngineNotifyPowerChangeFn;

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

Parâmetros

[in, out] Pipeline

Ponteiro para a estrutura WINBIO_PIPELINE associada à unidade biométrica que executa a operação.

[in] PowerEventType

Indica a natureza da alteração. Pode ser um dos seguintes valores:

  • PBT_APMSUSPEND

O sistema está entrando em um estado de baixa potência.

  • PBT_APMRESUMEAUTOMATIC

O sistema está retornando de um estado de baixa potência.

  • PBT_APMPOWERSTATUSCHANGE

O status da fonte de alimentação do sistema está mudando (por exemplo, o sistema mudou de bateria para energia de linha ou a bateria está ficando baixa).

Retornar valor

Se a função for bem-sucedida, ela retornará S_OK. Se a função falhar, ela retornará um valor HRESULT que indica o erro. Os possíveis valores incluem, mas sem limitação, aqueles na tabela a seguir. Para obter uma lista de códigos de erro comuns, consulte Valores HRESULT comuns.

Comentários

Quando ele recebe um evento PBT_APMPOWERSTATUSCHANGE, o adaptador deve chamar a APIGetSystemPowerStatus do Microsoft Win32 para determinar a nova status de energia.

A estrutura biométrica chama esse ponto de entrada do adaptador de forma assíncrona no contexto de um thread arbitrário. É responsabilidade do adaptador sincronizar o processamento dessa chamada com qualquer outro trabalho que possa estar fazendo.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 8 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2012 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho winbio_adapter.h

Confira também

GetSystemPowerStatus

PBT_APMPOWERSTATUSCHANGE