WINBIO_EXTENDED_ENROLLMENT_STATUS 結構

發行項
06/13/2023

包含有關進行中註冊狀態的其他資訊。

語法

typedef struct _WINBIO_EXTENDED_ENROLLMENT_STATUS {
  HRESULT                  TemplateStatus;
  WINBIO_REJECT_DETAIL     RejectDetail;
  ULONG                    PercentComplete;
  WINBIO_BIOMETRIC_TYPE    Factor;
  WINBIO_BIOMETRIC_SUBTYPE SubFactor;
  union {
    ULONG32 Null;
    struct {
      RECT BoundingBox;
      LONG Distance;
    } FacialFeatures;
    struct {
      ULONG GeneralSamples;
      ULONG Center;
      ULONG TopEdge;
      ULONG BottomEdge;
      ULONG LeftEdge;
      ULONG RightEdge;
    } Fingerprint;
    struct {
      RECT  EyeBoundingBox_1;
      RECT  EyeBoundingBox_2;
      POINT PupilCenter_1;
      POINT PupilCenter_2;
      LONG  Distance;
    } Iris;
    struct {
      ULONG32 Reserved;
    } Voice;
  } Specific;
} WINBIO_EXTENDED_ENROLLMENT_STATUS, *PWINBIO_EXTENDED_ENROLLMENT_STATUS;

成員

TemplateStatus

註冊範本的範例集合狀態。這個成員可以取得下列值。

值	意義
S_OK	註冊已準備好儲存。
WINBIO_E_INVALID_OPERATION	未進行註冊。
WINBIO_I_MORE_DATA	完成範本需要更多範例。
WINBIO_E_BAD_CAPTURE	最新的範例無法使用。

RejectDetail

如果 TemplateStatus 成員的值 是WINBIO_E_BAD_CAPTURE，則最新的範例無法使用的原因。

PercentComplete

引擎配接器中完成範本百分比的最佳估計值，其值為 0 到 100。

因素

此結構包含引擎配接器之功能和註冊需求的相關資訊生物特徵辨識單位類型。例如，如果 Factor 成員的值 是WINBIO_TYPE_FINGERPRINT， 則WINBIO_EXTENDED_ENGINE_INFO 結構會套用至指紋辨識器，並包含 Specifc.指紋 結構中的相關資訊。

SubFactor

WINBIO_BIOMETRIC_SUBTYPE值，提供註冊的其他資訊。

特定

特定生物特徵辨識因數進行中註冊狀態的相關資訊。

Null

保留的。必須為零。

FacialFeatures

臉部特徵進行中註冊狀態的相關資訊。

BoundingBox: 要註冊之個人臉部的相機框架內的位置，以圖元為單位。相機畫面的大小會決定這個位置的圖元數目上限。取得 WINBIO_PROPERTY_EXTENDED_SENSOR_INFO 屬性，以判斷相機畫面的大小。使用目前狀態監視器的用戶端必須執行縮放作業，以將位置對應至相機畫面。
距離: 臉部的實際位置與臉部的理想焦點距離之間的距離。此值的範圍從 -100 到 100。 0 表示理想的距離，正值表示臉部的實際位置太遠，負值表示實際位置太接近。

Fingerprint

指紋模式進行中註冊狀態的相關資訊。

GeneralSamples: 建立新指紋範本所需的樣本總數。
中心: 建立新指紋範本所需的指紋中心樣本數目。
TopEdge: 建立新指紋範本所需的指紋上邊緣樣本數目。
BottomEdge: 建立新指紋範本所需的指紋下邊緣樣本數目。
LeftEdge: 建立新指紋範本所需的指紋左邊緣樣本數目。
RightEdge: 建立新指紋範本所需的指紋右邊緣樣本數目。

虹膜

鳶尾花模式進行中註冊狀態的相關資訊。

EyeBoundingBox_1

要註冊之其中一個鳶尾花的相機畫面內的位置，以圖元為單位。如果鳶尾花辨識系統只監視一個眼睛，這個位置就是該眼睛的鳶尾花。如果鳶尾花辨識系統正在監視兩眼，但只有一個眼睛位於相機畫面格中，則此位置是相機畫面中眼睛的鳶尾花。如果鳶尾花辨識系統正在監視兩眼，而且兩眼都在相機畫面中，則此位置可能是個人右眼的鳶尾花。

相機畫面的大小會決定這個位置的圖元數目上限。取得 WINBIO_PROPERTY_EXTENDED_SENSOR_INFO 屬性，以判斷相機畫面的大小。使用目前狀態監視器的用戶端必須執行縮放作業，以將位置對應至相機畫面。

EyeBoundingBox_2

要註冊之其中一個鳶尾花的相機畫面內的位置，以圖元為單位。如果鳶尾花辨識系統只監視一個眼睛，或只有一個眼睛位於相機畫面中，則此值是空的。如果鳶尾花辨識系統正在監視兩眼，而且兩眼都在相機畫面中，則此位置可能是個人左眼的鳶尾花。

PupilCenter_1

要註冊之其中一個人員中樞的位置。如果鳶尾花辨識系統只監視一個眼睛，則此位置是該眼睛的中央。如果鳶尾花辨識系統正在監視這兩個眼睛，但只有一個眼睛位於相機畫面格中，則此位置是相機畫面中眼睛的中央。如果鳶尾花辨識系統正在監視兩眼，而且兩眼都在相機畫面中，則此位置可能是個人右眼的中央。

PupilCenter_2

要註冊之其中一個人員中樞的位置。如果鳶尾花辨識系統只監視一個眼睛，或只有一個眼睛位於相機畫面中，則此值是空的。如果鳶尾花辨識系統正在監視兩眼，而且兩眼都在相機畫面中，則此位置可能是個人左眼的中央。

距離

鳶尾花的實際位置與鳶尾花的理想焦點距離。此值的範圍從 -100 到 100。 0 表示理想的距離，正值表示鳶尾花的實際位置太遠，負值表示實際位置太接近。

語音

語音模式進行中註冊狀態的相關資訊。

已保留: 保留的。

規格需求

需求	值
最低支援的用戶端	Windows 10 [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2016 [僅限傳統型應用程式]
標頭	Winbio_types.h (包含用戶端應用程式的 Winbio.h，或適用于介面卡的 Winbio_adapters.h)

共用方式為

WINBIO_EXTENDED_ENROLLMENT_STATUS 結構

語法

成員

規格需求

意見反應

其他資源