Compartilhar via

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

  • Artigo

Chamado pela Estrutura Biométrica do Windows quando o sistema estiver pronto para entrar em um estado de baixa potência ou quando o sistema 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_STORAGE_NOTIFY_POWER_CHANGE_FN PibioStorageNotifyPowerChangeFn;

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

Valor Significado
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 energia 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.

Código de retorno Descrição
E_POINTER
 O argumento Pipeline era NULL.
E_INVALIDARG
 O argumento PowerEventType não era um dos valores listados na tabela.

Comentários

Quando ele recebe um evento PBT_APMPOWERSTATUSCHANGE, o adaptador deve chamar a API GetSystemPowerStatus 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