Share via

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

無法辨識個人的其他資訊，包括說明如何更正失敗的意見反應。

身分識別

一旦識別出該個人，其存在就會受到監視的身分識別。

TrackingId

由配接器產生的整數，並唯一識別個別。 只要配接器保留在相機畫面中，配接器指派給特定個人的追蹤識別碼就一定是固定的。

票

保留。 由配接器設定為 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_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_E_BAD_CAPTURE WINBIO_PRESENCE結構 之後，就會產生單 一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）。

    在此情況下，生物特徵辨識服務會將追蹤識別碼與個人的 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 。 引擎配接器可藉由在 EngineAdapterIdentifyAll 傳回的陣列 中包含WINBIO_PRESENCE結構，以防止生物特徵辨識服務產生 具有WINBIO_CHANGE_TYPE_DEPART 值的結構，其中 WINBIO_PRESENCE。 狀態 成員是 S_OK 和 WINBIO_PRESENCE。Identity.Type 成員WINBIO_ID_TYPE_Null ，如上述備註所述。 此動作會延長追蹤識別碼的到期時間，而不會造成任何用戶端活動。

需求

需求 值
最低支援的用戶端
 Windows 10 [僅限傳統型應用程式]
最低支援的伺服器
 Windows Server 2016 [僅限傳統型應用程式]
標題
Winbio_types.h （包括用戶端應用程式的 Winbio.h 或配接器的 Winbio_adapters.h）

另請參閱

WINBIO_ASYNC_RESULT

WinBioMonitorPresence

EngineAdapterIdentifyAll