다음을 통해 공유

WINBIO_PRESENCE 구조체

  • 아티클

현재 상태를 모니터링 중인 개인의 존재에 대한 정보를 포함합니다.

구문

typedef struct _WINBIO_PRESENCE {
  WINBIO_BIOMETRIC_TYPE      Factor;
  WINBIO_BIOMETRIC_SUBTYPE   SubFactor;
  HRESULT                    Status;
  WINBIO_REJECT_DETAIL       RejectDetail;
  WINBIO_IDENTITY            Identity;
  ULONGLONG                  TrackingId;
  WINBIO_PROTECTION_TICKET   Ticket;
  WINBIO_PRESENCE_PROPERTIES Properties;
} WINBIO_PRESENCE, *PWINBIO_PRESENCE;

멤버

요소

개인의 존재를 모니터링하는 데 사용되는 바이오 메트릭 요소입니다.

SubFactor

개인의 존재를 모니터링하는 데 사용되는 바이오 메트릭 요소에 대한 바이오 메트릭 하위 요소 한정자입니다.

상태

개인에 대한 식별 절차의 상태.

RejectDetail

실패를 해결하는 방법을 설명하는 피드백을 포함하여 개인을 인식하지 못하는 것에 대한 추가 정보입니다.

ID

해당 개인이 식별되면 현재 상태를 모니터링하는 개인의 ID입니다.

TrackingId

어댑터에서 생성되고 개인을 고유하게 식별하는 정수입니다. 어댑터가 특정 개인에게 할당하는 추적 식별자는 해당 사용자가 카메라 프레임에서 다시 기본 한 일정하게 유지됩니다.

Ticket

예약되었습니다. 어댑터에서 0으로 설정합니다.

속성

개인의 위치에 대한 요소별 정보입니다.

설명

EngineAdapterIdentifyAll 함수는 WINBIO_PRESENCE 구조의 배열을 만들고 이 배열을 바이오 메트릭 서비스로 보냅니다. 바이오 메트릭 서비스는 배열을 사용하여 컴퓨터 근처에 있는 사람의 내부 모델을 업데이트합니다.

이 업데이트의 결과에 따라 바이오 메트릭 서비스는 활성 상태 모니터가 있는 모든 클라이언트에 대해 WinBioMonitorPresence 함수에 대한 WINBIO_ASYNC_RESULT 구조를 생성할 수 있습니다. WINBIO_ASYNC_RESULT. 구조체의 작업 멤버에는 WINBIO_OPERATION_MONITOR_PRESENCE 및 WINBIO_ASYNC_RESULT 포함됩니다. Parameters.MonitorPresence.ChangeType 멤버는 개별 상태에 대한 추가 정보를 제공합니다.

엔진 어댑터가 특정 추적 식별자와 연결하는 개인이 입력 스트림에 처음으로 나타나면 바이오 메트릭 서비스는 WINBIO_ASYNC_RESULT 클라이언트 쪽 WINBIO_ASYNC_RESULT 구조를 생성합니다. Parameters.MonitorPresence.ChangeType 멤버가 WINBIO_CHANGE_TYPE_ARRIVAL. 이 구조는 WINBIO_ASYNC_RESULT 다른 WINBIO_ASYNC_RESULT 구조 앞에 애플리케이션 콜백 함수 또는 애플리케이션 메시지 큐로 전송됩니다. Parameters.MonitorPresence.PresenceArray에는 WINBIO_PRESENCE 동일한 값을 가진 WINBIO_PRESENCE 구조체가 포함되어 있습니다. TrackingId.

WINBIO_ASYNC_RESULT WINBIO_PRESENCE 구조의 배열에 있는 값의 다음 조합입니다. Parameters.MonitorPresence.PresenceArray 멤버는 개별 상태의 특정 변경 종류를 나타냅니다.

  • 개인이 카메라 프레임에 표시되지만 엔진이 여전히 개인을 식별하려고 하는 경우 WINBIO_PRESENCE 구조체의 멤버는 다음 표의 값을 갖습니다.

    멤버 값
    TrackingId 엔진의 개인을 식별하는 정수입니다.
    상태 S_OK
    Identity.Type WINBIO_ID_TYPE_NULL

    이 경우 바이오 메트릭 서비스는 개인의 만료 시간을 연장하고 WINBIO_ASYNC_RESULT 추적 식별자에 대한 클라이언트 쪽 WINBIO_ASYNC_RESULT 구조를 생성하지 않습니다. Parameters.MonitorPresence.ChangeType 멤버가 WINBIO_CHANGE_TYPE_RECOGNIZE.

    상태 멤버가 S_OK Identity.Type 멤버가 WINBIO_PRESENCE 구조체를 포함하는 WINBIO_ASYNC_RESULT 구조체가 처음 포함되고 하나 이상의 WINBIO_ASYNC_RESULT 구조체에 WINBIO_E_BAD_CAPTURE 상태 멤버가 포함된 WINBIO_PRESENCE 구조가 포함된 후 Identity.Type 멤버가 WINBIO_ID_TYPE_NULL 경우 프레즌스 모니터는 단일 WINBIO_ASYNC_RESULT 생성합니다. 는 WINBIO_ASYNC_RESULT 추적 식별자에 대한 구조체입니다. Parameters.MonitorPresence.ChangeType 멤버가 WINBIO_CHANGE_TYPE_TRACK. 이 WINBIO_ASYNC_RESULT 구조체는 WINBIO_ASYNC_RESULT. Parameters.MonitorPresence.ChangeType 멤버는 WINBIO_CHANGE_TYPE_TRACK WINBIO_E_BAD_CAPTURE 오류를 발생시킨 문제가 해결되었음을 클라이언트에 알릴 수 있습니다. WINBIO_PRESENCE 구조에 상태 멤버가 WINBIO_E_BAD_CAPTURE 있는 상황에 대한 자세한 내용은 이 설명의 뒷부분에 있는 인식 오류를 수정하기 위해 엔진 어댑터가 사용자에게 피드백을 제공하는 방법에 대한 설명을 참조하세요.

  • 개인이 카메라 프레임에 표시되지만 엔진이 여전히 개인을 식별하려고 하고 인식 실패를 수정하는 방법에 대한 피드백을 사용자에게 제공하려는 경우 WINBIO_PRESENCE 구조체의 멤버는 다음 표의 값을 갖습니다.

    멤버 값
    TrackingId 엔진의 개인을 식별하는 정수입니다.
    상태 WINBIO_E_BAD_CAPTURE
    Identity.Type WINBIO_ID_TYPE_NULL
    Factor 값이 WINBIO_TYPE_FACIAL_FEATURES 경우 Properties.FacialFeatures.BoundingBox 카메라 프레임 내에서 개인의 얼굴 위치입니다.
    Factor 값이 WINBIO_TYPE_IRIS 경우 Properties.Iris.BoundingBox 카메라 프레임 내에서 개인의 붓꽃 또는 붓꽃의 위치입니다.

    이 경우 바이오 메트릭 서비스는 개인의 만료 시간을 연장하고 WINBIO_ASYNC_RESULT 추적 식별자에 대한 WINBIO_ASYNC_RESULT 구조를 생성합니다. Parameters.MonitorPresence.ChangeType 멤버가 WINBIO_CHANGE_TYPE_TRACK.

  • 개인이 카메라 프레임에 표시되고 엔진 어댑터가 개인의 ID를 결정하는 경우 WINBIO_PRESENCE 구조체의 멤버는 다음 표의 값을 갖습니다.

    멤버 값
    TrackingId 엔진의 개인을 식별하는 정수입니다.
    상태 S_OK
    Identity.Type WINBIO_ID_TYPE_SID
    Identity.Value.AccountSid 개인의 SID(보안 식별자)입니다.

    이 경우 바이오 메트릭 서비스는 추적 식별자를 개인의 SID와 연결하고 WINBIO_ASYNC_RESULT 추적 식별자에 대한 클라이언트 쪽 WINBIO_ASYNC_RESULT 구조를 생성합니다. Parameters.MonitorPresence.ChangeType 멤버가 WINBIO_CHANGE_TYPE_RECOGNIZE. 바이오 메트릭 서비스는 개별이 카메라 프레임을 벗어나지 않는 한 추적 식별자에 대한 추가 클라이언트 쪽 WINBIO_ASYNC_RESULT 구조를 생성하지 않습니다.

  • 개별이 카메라 프레임에 표시되지만 엔진 어댑터가 개인이 등록되지 않은지 확인하면 WINBIO_PRESENCE 구조체의 멤버는 다음 표의 값을 갖습니다.

    멤버 값
    TrackingId 엔진의 개인을 식별하는 정수입니다.
    상태 WINBIO_E_UNKNOWN_ID
    Identity.Type WINBIO_ID_TYPE_NULL

    이 경우 바이오 메트릭 서비스는 개인의 추적 식별자를 UNKNOWN ID와 연결하고 WINBIO_ASYNC_RESULT 추적 식별자에 대한 클라이언트 쪽 WINBIO_ASYNC_RESULT 구조를 생성합니다. Parameters.MonitorPresence.ChangeType 멤버가 WINBIO_CHANGE_TYPE_RECOGNIZE. 바이오 메트릭 서비스는 개별이 카메라 프레임을 벗어나지 않는 한 추적 식별자에 대한 추가 클라이언트 쪽 WINBIO_ASYNC_RESULT 구조를 생성하지 않습니다.

엔진 어댑터가 특정 추적 식별자와 연결하는 개인이 카메라 프레임을 벗어나 EngineAdapterIdentifyAll 함수가 반환하는 값에 나타나지 않으면 추적 식별자가 결국 만료됩니다. 추적 식별자가 만료되면 바이오 메트릭 서비스는 WINBIO_ASYNC_RESULT 클라이언트 쪽 WINBIO_ASYNC_RESULT 구조를 생성합니다. Parameters.MonitorPresence.ChangeType 멤버가 WINBIO_CHANGE_TYPE_DEPART. 엔진 어댑터는 WINBIO_PRESENCE EngineAdapterIdentifyAll이 반환하는 배열에 WINBIO_PRESENCE 구조를 포함하여 바이오 메트릭 서비스가 WINBIO_CHANGE_TYPE_DEPART 값으로 이 구조를 생성하지 못하도록 방지할 수 있습니다. 상태 멤버가 S_OK WINBIO_PRESENCE. Identity.Type 멤버는 이 설명의 앞부분에서 설명한 대로 WINBIO_ID_TYPE_NULL. 이 작업은 클라이언트 쪽 작업을 유발하지 않고 추적 식별자의 만료 시간을 연장합니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트
 Windows 10 [데스크톱 앱만 해당]
지원되는 최소 서버
 Windows Server 2016 [데스크톱 앱만 해당]
헤더
Win바이오_types.h(클라이언트 애플리케이션의 경우 Win바이오.h, 어댑터의 경우 Win바이오_adapters.h 포함)

참고 항목

WINBIO_ASYNC_RESULT

WinBioMonitorPresence

EngineAdapterIdentifyAll