PIBIO_ENGINE_IDENTIFY_ALL_FN 콜백 함수(winbio_adapter.h)

Windows 생체 인식 프레임워크에서 호출되어 현재 카메라 프레임에 있는 모든 사람의 ID를 확인합니다.

구문

PIBIO_ENGINE_IDENTIFY_ALL_FN PibioEngineIdentifyAllFn;

HRESULT PibioEngineIdentifyAllFn(
  [in, out] PWINBIO_PIPELINE Pipeline,
  [out]     PSIZE_T PresenceCount,
  [out]     PWINBIO_PRESENCE *PresenceArray
)
{...}

매개 변수

[in, out] Pipeline

작업을 수행하는 생체 인식 단위와 연결된 WINBIO_PIPELINE 구조체에 대한 포인터입니다.

[out] PresenceCount

함수에서 검색한 현재 상태 수를 수신하는 변수의 주소입니다.

[out] PresenceArray

WINBIO_PRESENCE 요소 배열에 대한 포인터를 받는 변수의 주소입니다.

반환 값

함수가 성공하면 S_OK를 반환합니다. 함수가 실패하면 다음 HRESULT 값 중 하나를 반환하여 오류를 나타내야 합니다.

설명

생체 인식 서비스는 엔진 어댑터에 새 데이터 프레임을 보낸 후 이 메서드를 호출합니다.

데이터 프레임을 처리한 후 이 함수는 데이터 프레임에서 검색된 각 현재 상태에 대해 하나의 WINBIO_PRESENCE 요소를 반환해야 합니다.

EngineAdapterIdentifyAll 함수가 프레임에서 얼굴을 찾을 수 없는 경우 S_OKHRESULT를 반환하고 PresenceCount 및 PresenceArray 반환 매개 변수를 각각 0 및 NULL로 설정합니다. 즉, 사람의 존재를 포함하지 않는 프레임은 오류 조건이 아닙니다.

EngineAdapterIdentifyAll이 S_OK 이외의 HRESULT를 반환해야 하는 유일한 시간은 바이오 서비스가 프레임을 사용하여 프레즌스 모니터 상태를 업데이트하지 않으려는 경우입니다. 이 경우는 드물어야 합니다. 엔진 어댑터는 PresenceArray 매개 변수에서 반환하는 WINBIO_PRESENCE 요소의 배열을 할당합니다. HeapAlloc 함수를 사용하여 프로세스 힙에서 이 메모리를 할당해야 합니다. 배열이 만들어지면 Windows 생체 인식 프레임워크의 속성이 됩니다. 프레임워크는 이 메모리를 사용한 후 할당을 취소하므로 엔진 어댑터가 배열의 할당을 취소하거나 포인터를 저장하려고 시도해서는 안 됩니다. 이 규칙을 따르지 않으면 힙 손상 및 생체 인식 서비스의 충돌 가능성으로 이어질 수 있습니다.

PresenceArray의 개별 WINBIO_PRESENCE 항목 값에 따라 클라이언트 애플리케이션에 대해 생성된 이벤트가 결정됩니다. 자세한 내용은 WINBIO_PRESENCE 구조에 대한 설명을 참조하세요.

요구 사항