Compartilhar via

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

  • Artigo

Chamado pela Estrutura Biométrica do Windows para obter um conjunto de dados de calibragem pós-captura do adaptador do mecanismo.

Sintaxe

PIBIO_ENGINE_QUERY_CALIBRATION_DATA_FN PibioEngineQueryCalibrationDataFn;

HRESULT PibioEngineQueryCalibrationDataFn(
  [in, out] PWINBIO_PIPELINE Pipeline,
  [out]     PBOOLEAN DiscardAndRepeatCapture,
  [out]     PUCHAR CalibrationBuffer,
  [out]     PSIZE_T CalibrationBufferSize,
  [in]      SIZE_T MaxBufferSize
)
{...}

Parâmetros

[in, out] Pipeline

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

[out] DiscardAndRepeatCapture

Endereço de um valor booliano que deve ser definido pelo método EngineAdapterQueryCalibrationData . Esse valor indica o que o serviço biométrico deve fazer com o exemplo atual após a conclusão da calibragem.

  • TRUE indica que a amostra biométrica capturada é inutilizável. O serviço biométrico descartará o exemplo e coletará um novo.
  • FALSE indica que o exemplo é utilizável e o Mecanismo deve ser instruído a executar outras operações nele.

[out] CalibrationBuffer

Endereço de um buffer vazio em que o método deve gravar seus dados de calibragem. A memória que contém esse buffer pertence ao serviço biométrico e o Adaptador de Mecanismo não deve manter nenhum ponteiro para esse buffer depois que o método EngineAdapterQueryCalibrationData retornar.

[out] CalibrationBufferSize

Endereço de uma variável em que o método EngineAdapterQueryCalibrationData armazenará o tamanho (em bytes) dos dados de calibragem gravados no CalibrationBuffer. Esse valor não deve exceder MaxBufferSize.

Se EngineAdapterQueryCalibrationData definir esse valor como zero, o conteúdo do CalibrationBuffer será descartado sem enviá-los para o Adaptador de Sensor. Esta não é uma condição de erro; ele simplesmente indica que o Adaptador de Mecanismo não precisa atualizar a calibragem do sensor com base nos dados de captura atuais.

[in] MaxBufferSize

Um valor que indica o espaço máximo (em bytes) disponível para o Adaptador de Mecanismo no CalibrationBuffer.

Retornar valor

Se a função for bem-sucedida, ela retornará S_OK. Se a função falhar, ela deverá retornar um dos seguintes valores HRESULT para indicar o erro.

Código de retorno Descrição
E_some_error
Qualquer código de erro fará com que o Serviço Biométrico descontinue o loop de calibragem dinâmica e anule a operação de captura.

Comentários

O método EngineAdapterQueryCalibrationData pode controlar independentemente o comportamento de captura repetida do serviço biométrico e o comportamento de calibragem definindo DiscardAndRepeatCapture e CalibrationBufferSize, respectivamente.

Comportamento desejado DiscardAndRepeatCapture CalibrationBufferSize
Repita a captura após a calibragem. TRUE Diferente de zero
Repita a captura sem calibragem. TRUE Zero
Continue processando o exemplo após a calibragem. FALSE Diferente de zero
Continue processando o exemplo sem calibragem. FALSE Zero

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 10 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2016 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho winbio_adapter.h (inclua Winbio_adapter.h)