PIBIO_SENSOR_QUERY_CALIBRATION_FORMATS_FN回调函数 (winbio_adapter.h)

由 Windows 生物识别框架调用，以确定传感器适配器支持的校准格式集。

语法

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

参数

[in, out] Pipeline

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

[out] FormatArray

空 WINBIO_UUID 项数组的地址。 SensorAdapterQueryCalibrationFormats 方法应用一个或多个标识传感器适配器已知的校准数据格式的 UUID 填充此数组。

[in] FormatArraySize

一个值，该值指示 FormatArray 中可用的槽数。 SensorAdapterQueryCalibrationFormats 方法不得尝试将超过此数量的元素写入 FormatArray，否则结果将不可预知。

[out] FormatCount

指向一个变量的指针，该变量接收 在 FormatArray 中返回的 UUID 数。 SensorAdapterQueryCalibrationFormats 方法必须在返回之前设置此值。

返回值

如果函数成功，则返回 S_OK。 如果函数失败，它必须返回以下 HRESULT 值之一来指示错误。

返回代码	说明
E_NOTIMPL	- 传感器适配器不支持动态校准。
E_some_other_error	任何其他错误代码都将导致 Windows 生物识别框架记录错误并中止生物识别单元的配置。

注解

此方法在生物识别单元的初始配置期间调用一次。

传感器适配器支持的每个校准格式都由单独的 UUID 值标识。

此方法在任意 RPC 服务器线程的上下文中执行。

如果传感器适配器不支持动态校准，它应返回 E_NOTIMPL值。 除非引擎适配器需要动态校准，否则 Windows 生物识别框架不会将此视为错误。 (有关详细信息，请参阅 EngineAdapterSelectCalibrationFormat 方法的说明。)

如果此方法返回 值 S_OK，则必须设置 FormatArray 和 FormatCount 。 此方法返回 S_OK 以及 FormatCount 的零值是错误的。 这样做将导致 Windows 生物识别框架记录 WINBIO_E_INVALID_CALIBRATION_FORMAT_ARRAY 错误消息并中止生物识别单元的配置。

要求

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