Поделиться через

структура 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;

Участники

Множитель

Фактор биография метрики, используемый для мониторинга присутствия отдельного человека.

Подфактор

Квалификатор подфактор биография метрик для коэффициента биография метрик, используемого для мониторинга присутствия отдельного человека.

Состояние

Состояние процедуры идентификации для отдельного человека.

ОтклонитьDetail

Дополнительные сведения о неудаче распознавания человека, включая отзывы, которые объясняют, как исправить сбой.

Identity

Личность человека, присутствие которого отслеживается, после идентификации этого человека.

TrackingId

Целое число, созданное адаптером, идентифицирует его уникально. Идентификатор отслеживания, который адаптер назначает конкретному человеку, гарантированно будет константой, пока этот человек остается в кадре камеры.

Билет

Зарезервировано. Установите значение 0 адаптером.

Свойства

Сведения о положении отдельного человека.

Замечания

Функция EngineAdapterIdentifyAll создает массив структур WINBIO_PRESENCE и отправляет этот массив в службу метрик биография. Служба биография метрики использует массив для обновления внутренней модели людей рядом с компьютером.

В зависимости от результатов этого обновления служба биография метрики может создать WINBIO_ASYNC_RESULT структуру для функции WinBioMonitorPresence для всех клиентов с активными мониторами присутствия. 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_PRESENCE , которые WINBIO_ASYNC_RESULT. Элемент 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.

    В первый раз, когда структура WINBIO_ASYNC_RESULT включает WINBIO_PRESENCE структуру, в которой элемент состояния S_OK, а элемент Identity.Type WINBIO_ID_TYPE_NULL после одной или нескольких структур WINBIO_ASYNC_RESULT включал структуру WINBIO_PRESENCE со элементом состояния WINBIO_E_BAD_CAPTURE, монитор присутствия создает один 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
    Properties.FacialFeatures.BoundingBox, если значение factor равно WINBIO_TYPE_FACIAL_FEATURES Расположение лица человека в кадре камеры.
    Properties.Iris.BoundingBox, если значение factor равно WINBIO_TYPE_IRIS Расположение ириса или ириса отдельного человека в кадре камеры.

    В этом случае служба метрик биография расширяет срок действия отдельного пользователя и создает структуру WINBIO_ASYNC_RESULT для идентификатора отслеживания, в котором WINBIO_ASYNC_RESULT. Элемент Parameters.MonitorPresence.ChangeType WINBIO_CHANGE_TYPE_TRACK.

  • Если отдельный объект отображается в кадре камеры, а адаптер подсистемы определяет удостоверение отдельного человека, члены структуры WINBIO_PRESENCE имеют значения в следующей таблице.

    Элемент Значение
    TrackingId Целое число, определяющее личность обработчика.
    Состояние S_OK
    Identity.Type WINBIO_ID_TYPE_SID
    Identity.Value.AccountSid Идентификатор безопасности (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 и создает клиентская 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_CHANGE_TYPE_DEPART путем включения WINBIO_PRESENCE структуры в массив, возвращаемого EngineAdapterIdentifyAll, где WINBIO_PRESENCE. Элемент состояния 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