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
EngineAdapterSelectCalibrationFormat 메서드가 선택한 보정 형식의 UUID를 저장하는 WINBIO_UUID 항목의 주소입니다. FormatArray 매개 변수의 UUID 중 하나여야 합니다.
[out] MaxBufferSize
EngineAdapterSelectCalibrationFormat 메서드가 센서 어댑터로 돌아가려는 보정 데이터의 최대 크기(바이트)를 저장하는 변수의 주소입니다. 이 버퍼의 최대 크기는 4096바이트 이하여야 합니다.
반환 값
함수는 다음 HRESULT 값 중 하나를 반환합니다.
반환 코드 | 설명 |
---|---|
|
작업에 성공했습니다. SelectedFormat 및 MaxBufferSize 반환 값이 모두 설정되었습니다. |
|
엔진 어댑터에는 동적 보정이 필요하지 않습니다. 오류 조건이 아닙니다. 생체 인식 서비스는 이 값을 S_OK 변환하고 생체 인식 단위는 동적 보정을 사용하지 않도록 구성됩니다. |
|
엔진 어댑터에는 동적 보정이 필요하지만 FormatArray 매개 변수에 지정된 보정 형식은 지원하지 않습니다. FormatCount 인수가 0인 경우에도 엔진 어댑터가 이 오류 코드를 반환해야 합니다. 이 오류 코드로 인해 생체 인식 서비스에서 오류를 기록하고 생체 인식 단위의 구성을 중단합니다. |
|
다른 오류 코드로 인해 생체 인식 서비스에서 오류를 기록하고 생체 인식 단위의 구성을 중단합니다. |
설명
이 메서드는 생체 인식 단위를 구성하는 동안 한 번 호출됩니다. 보정 형식을 선택한 후에는 변경할 수 없습니다.
요구 사항
요구 사항 | 값 |
---|---|
지원되는 최소 클라이언트 | Windows 10 [데스크톱 앱만 해당] |
지원되는 최소 서버 | Windows Server 2016 [데스크톱 앱만 해당] |
대상 플랫폼 | Windows |
헤더 | winbio_adapter.h(Winbio_adapter.h 포함) |