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

  • Artigo

Chamado pela Estrutura Biométrica do Windows para determinar qual dos formatos de calibragem do Adaptador de Sensor o Adaptador de Mecanismo deseja usar.

Sintaxe

PIBIO_ENGINE_SELECT_CALIBRATION_FORMAT_FN PibioEngineSelectCalibrationFormatFn;

HRESULT PibioEngineSelectCalibrationFormatFn(
  [in, out] PWINBIO_PIPELINE Pipeline,
  [in]      PWINBIO_UUID FormatArray,
  [in]      SIZE_T FormatCount,
  [out]     PWINBIO_UUID SelectedFormat,
  [out]     PSIZE_T MaxBufferSize
)
{...}

Parâmetros

[in, out] Pipeline

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

[in] FormatArray

Endereço de uma matriz de WINBIO_UUID itens que identificam os formatos de dados de calibragem compatíveis com o Adaptador de Sensor. Espera-se que o Adaptador de Mecanismo escolha um desses formatos para seus dados de calibragem.

[in] FormatCount

Valor que indica o número de UUIDs no parâmetro FormatArray .

[out] SelectedFormat

Endereço de um item WINBIO_UUID em que o método EngineAdapterSelectCalibrationFormat armazenará o UUID do formato de calibragem selecionado. Esse deve ser um dos UUIDs no parâmetro FormatArray .

[out] MaxBufferSize

Endereço de uma variável em que o método EngineAdapterSelectCalibrationFormat armazenará o tamanho máximo (em bytes) de todos os dados de calibragem que planeja retornar ao Adaptador de Sensor. O tamanho máximo desse buffer deve ser de 4096 bytes ou menos.

Retornar valor

A função retornará um dos seguintes valores HRESULT .

Código de retorno Descrição
S_OK
A operação foi realizada com êxito. Os valores retornados SelectedFormat e MaxBufferSize foram definidos.
E_NOTIMPL
O Adaptador de Mecanismo não requer calibragem dinâmica. Isso não é uma condição de erro. O Serviço Biométrico converterá esse valor em S_OK e a unidade biométrica será configurada para não usar a calibragem dinâmica.
WINBIO_E_NO_SUPPORTED_CALIBRATION_FORMAT
O Adaptador de Mecanismo requer calibragem dinâmica, mas não dá suporte a nenhum dos formatos de calibragem especificados no parâmetro FormatArray . (O Adaptador do Mecanismo também deverá retornar esse código de erro se o argumento FormatCount for zero.) Esse código de erro fará com que o Serviço Biométrico registre o erro e anule a configuração da unidade biométrica.
E_some_other_error
Qualquer outro código de erro fará com que o Serviço Biométrico registre o erro e anule a configuração da unidade biométrica.

Comentários

Esse método é chamado uma vez durante a configuração da unidade biométrica. Depois que um formato de calibragem tiver sido selecionado, ele não poderá ser alterado.

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)