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

Chamado pela Estrutura Biométrica do Windows para determinar o conjunto de formatos de calibragem com suporte do Adaptador de Sensor.

Sintaxe

PIBIO_SENSOR_QUERY_CALIBRATION_FORMATS_FN PibioSensorQueryCalibrationFormatsFn;

HRESULT PibioSensorQueryCalibrationFormatsFn(
  [in, out] PWINBIO_PIPELINE Pipeline,
  [out]     PWINBIO_UUID FormatArray,
  [in]      SIZE_T FormatArraySize,
  [out]     PSIZE_T FormatCount
)
{...}

Parâmetros

[in, out] Pipeline

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

[out] FormatArray

Endereço de uma matriz de itens WINBIO_UUID vazios. Espera-se que o método SensorAdapterQueryCalibrationFormats preencha essa matriz com um ou mais UUIDs identificando os formatos de dados de calibragem conhecidos pelo Adaptador de Sensor.

[in] FormatArraySize

Um valor que indica o número de slots disponíveis em FormatArray. O método SensorAdapterQueryCalibrationFormats não deve tentar gravar mais do que esse número de elementos em FormatArray ou os resultados serão imprevisíveis.

[out] FormatCount

Ponteiro para uma variável que recebe o número UUIDs retornado em FormatArray. O método SensorAdapterQueryCalibrationFormats deve definir esse valor antes de retornar.

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_NOTIMPL	– O Adaptador de Sensor não dá suporte à calibragem dinâmica.
E_some_other_error	Qualquer outro código de erro fará com que a Estrutura Biométrica do Windows registre o erro e anule a configuração da unidade biométrica.

Comentários

Esse método é chamado uma vez durante a configuração inicial de uma unidade biométrica.

Cada formato de calibragem compatível com o Adaptador de Sensor é identificado por um valor UUID separado.

Esse método é executado no contexto de um thread arbitrário do servidor RPC.

Se o Adaptador de Sensor não der suporte à calibragem dinâmica, ele deverá retornar um valor de E_NOTIMPL. A Estrutura Biométrica do Windows não tratará isso como um erro, a menos que o Adaptador de Mecanismo exija calibragem dinâmica. (Para obter detalhes, consulte a descrição do método EngineAdapterSelectCalibrationFormat .)

Se esse método retornar um valor de S_OK, FormatArray e FormatCount deverão ser definidos. É um erro para esse método retornar S_OK juntamente com um valor zero para FormatCount. Isso fará com que a Estrutura Biométrica do Windows registre uma mensagem de erro WINBIO_E_INVALID_CALIBRATION_FORMAT_ARRAY e anule a configuração da unidade biométrica.

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)