다음을 통해 공유


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 값 중 하나를 반환합니다.

반환 코드 설명
S_ok
작업에 성공했습니다. SelectedFormatMaxBufferSize 반환 값이 모두 설정되었습니다.
E_notimpl
엔진 어댑터에는 동적 보정이 필요하지 않습니다. 오류 조건이 아닙니다. 생체 인식 서비스는 이 값을 S_OK 변환하고 생체 인식 단위는 동적 보정을 사용하지 않도록 구성됩니다.
WINBIO_E_NO_SUPPORTED_CALIBRATION_FORMAT
엔진 어댑터에는 동적 보정이 필요하지만 FormatArray 매개 변수에 지정된 보정 형식은 지원하지 않습니다. FormatCount 인수가 0인 경우에도 엔진 어댑터가 이 오류 코드를 반환해야 합니다. 이 오류 코드로 인해 생체 인식 서비스에서 오류를 기록하고 생체 인식 단위의 구성을 중단합니다.
E_some_other_error
다른 오류 코드로 인해 생체 인식 서비스에서 오류를 기록하고 생체 인식 단위의 구성을 중단합니다.

설명

이 메서드는 생체 인식 단위를 구성하는 동안 한 번 호출됩니다. 보정 형식을 선택한 후에는 변경할 수 없습니다.

요구 사항

요구 사항
지원되는 최소 클라이언트 Windows 10 [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2016 [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 winbio_adapter.h(Winbio_adapter.h 포함)