PWINBIO_LOCATE_SENSOR_CALLBACK 콜백 함수(winbio.h)
비동기 WinBioLocateSensorWithCallback 함수의 결과를 반환하기 위해 Windows 생체 인식 프레임워크에서 호출됩니다. 클라이언트 애플리케이션은 이 함수를 구현해야 합니다.
중요 Windows 8 시작하여 더 이상 PWINBIO_LOCATE_SENSOR_CALLBACK/WinBioLocateSensorWithCallback 조합을 사용하지 않는 것이 좋습니다. 대신 다음을 수행합니다.
- 작업이 완료되면 알림을 받을 PWINBIO_ASYNC_COMPLETION_CALLBACK 함수를 구현합니다.
- WinBioAsyncOpenSession 함수를 호출합니다. 콜백의 주소를 CallbackRoutine 매개 변수에 전달합니다. NotificationMethod 매개 변수에 WINBIO_ASYNC_NOTIFY_CALLBACK 전달합니다. 비동기 세션 핸들을 검색합니다.
- 비동기 세션 핸들을 사용하여 WinBioLocateSensor를 호출합니다. 작업이 완료되면 Windows 생체 인식 프레임워크는 결과를 사용하여 WINBIO_ASYNC_RESULT 구조를 할당하고 초기화하고 결과 구조에 대한 포인터를 사용하여 콜백을 호출합니다.
- 콜백 구현에서 WinBioFree 를 호출하여 사용을 완료한 후 WINBIO_ASYNC_RESULT 구조를 해제합니다.
구문
PWINBIO_LOCATE_SENSOR_CALLBACK PwinbioLocateSensorCallback;
void PwinbioLocateSensorCallback(
[in, optional] PVOID LocateCallbackContext,
[in] HRESULT OperationStatus,
WINBIO_UNIT_ID UnitId
)
{...}
매개 변수
[in, optional] LocateCallbackContext
애플리케이션에서 정의하고 WinBioLocateSensorWithCallback 함수의 LocateCallbackContext 매개 변수에 전달된 버퍼에 대한 포인터입니다. 버퍼는 프레임워크 또는 생체 인식 단위에 의해 수정되지 않습니다. 애플리케이션은 데이터를 사용하여 수행할 작업을 결정하거나 생체 인식 캡처에 대한 추가 정보를 유지 관리할 수 있습니다.
[in] OperationStatus
캡처 작업에서 반환된 오류 코드입니다.
UnitId
생체 인식 단위 ID 번호입니다.
반환 값
없음
요구 사항
요구 사항 | 값 |
---|---|
지원되는 최소 클라이언트 | Windows 7 [데스크톱 앱만 해당] |
지원되는 최소 서버 | Windows Server 2008 R2 [데스크톱 앱만 해당] |
대상 플랫폼 | Windows |
헤더 | winbio.h |