Share via

PIBIO_ENGINE_SELECT_CALIBRATION_FORMAT_FN回调函数 (winbio_adapter.h)

  • 项目

由 Windows 生物识别框架调用，以确定引擎适配器要使用的传感器适配器校准格式。

语法

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
)
{...}

参数

[in, out] Pipeline

指向与执行操作的生物识别单元关联的 WINBIO_PIPELINE 结构的指针。

[in] FormatArray

标识传感器适配器支持的校准数据格式的 WINBIO_UUID 项数组的地址。 引擎适配器应为其校准数据选择以下格式之一。

[in] FormatCount

指示 FormatArray 参数中的 UUID 数的值。

[out] SelectedFormat

WINBIO_UUID项的地址，其中 EngineAdapterSelectCalibrationFormat 方法将存储所选校准格式的 UUID。 这必须是 FormatArray 参数中的 UUID 之一。

[out] MaxBufferSize

变量的地址， 其中 EngineAdapterSelectCalibrationFormat 方法将存储最大大小 (字节) 计划返回到传感器适配器的任何校准数据。 此缓冲区的最大大小必须为 4096 字节或更小。

返回值

函数将返回以下 HRESULT 值之一。

返回代码 说明
S_OK
操作成功。 SelectedFormat 和 MaxBufferSize 返回值都已设置。
E_NOTIMPL
引擎适配器不需要动态校准。 这不是错误条件。 生物识别服务会将此值转换为 S_OK，生物识别单元将被配置为不使用动态校准。
WINBIO_E_NO_SUPPORTED_CALIBRATION_FORMAT
引擎适配器需要动态校准，但不支持 FormatArray 参数中指定的任何校准格式。 (如果 FormatCount 参数为零，引擎适配器还应返回此错误代码。) 此错误代码将导致生物识别服务记录错误并中止生物识别单元的配置。
E_some_other_error
任何其他错误代码都将导致生物识别服务记录错误并中止生物识别单元的配置。

注解

在配置生物识别单元期间，将调用此方法一次。 选择校准格式后，无法更改该格式。

要求

要求 值
最低受支持的客户端 Windows 10 [仅限桌面应用]
最低受支持的服务器 Windows Server 2016 [仅限桌面应用]
目标平台 Windows
标头 winbio_adapter.h (包括 Winbio_adapter.h)