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.Fingerprint 構造体に関連情報が含まれます。

SubFactor

登録に関する追加情報を提供するWINBIO_BIOMETRIC_SUBTYPE値。

特定

特定の生体認証要素に対して進行中の登録の状態に関する情報。

Null

予約済み。ゼロを指定してください。

FacialFeatures

顔の特徴について進行中の登録の状態に関する情報。

BoundingBox: 登録する個人の顔のカメラフレーム内の位置 (ピクセル単位)。カメラフレームのサイズによって、この位置のピクセル数の上限が決まります。 WINBIO_PROPERTY_EXTENDED_SENSOR_INFO プロパティを取得して、カメラフレームのサイズを決定します。プレゼンスモニターを使用するクライアントは、スケーリング操作を実行して、位置をカメラフレームにマップする必要があります。
距離: 顔の実際の位置と顔の理想的な焦点との間の距離。この値の範囲は -100 ~ 100 です。 0 は理想的な距離を示し、正の値は顔の実際の位置が遠すぎることを示し、負の値は実際の位置が近すぎることを示します。

Fingerprint

指紋パターンで進行中の登録の状態に関する情報。

GeneralSamples: 新しい指紋テンプレートを作成するために必要なサンプルの合計数。
Center: 新しい指紋テンプレートを作成するために必要な指紋の中心のサンプルの数。
TopEdge: 新しい指紋テンプレートを作成するために必要な指紋の上端のサンプルの数。
BottomEdge: 新しい指紋テンプレートを作成するために必要な指紋の下端のサンプルの数。
LeftEdge: 新しい指紋テンプレートを作成するために必要な指紋の左端のサンプルの数。
RightEdge: 新しい指紋テンプレートを作成するために必要な指紋の右端のサンプルの数。

アイリス

虹彩パターンで進行中の登録の状態に関する情報。

EyeBoundingBox_1

登録する個人の虹彩の 1 つのカメラフレーム内の位置 (ピクセル単位)。虹彩認識システムが 1 つの目のみを監視している場合、この位置はその目の虹彩になります。虹彩認識システムが両方の目を監視しているが、1 つの目だけがカメラフレーム内にある場合、この位置はカメラフレーム内の目の虹彩になります。虹彩認識システムが両方の目を監視していて、両方の目がカメラフレームにある場合、この位置はおそらく個人の右目の虹彩です。

カメラフレームのサイズによって、この位置のピクセル数の上限が決まります。 WINBIO_PROPERTY_EXTENDED_SENSOR_INFO プロパティを取得して、カメラフレームのサイズを決定します。プレゼンスモニターを使用するクライアントは、スケーリング操作を実行して、位置をカメラフレームにマップする必要があります。

EyeBoundingBox_2

登録する個人の虹彩の 1 つのカメラフレーム内の位置 (ピクセル単位)。虹彩認識システムが 1 つの目のみを監視している場合、または 1 つの目だけがカメラフレーム内にある場合、この値は空です。虹彩認識システムが両方の目を監視していて、両方の目がカメラフレームにある場合、この位置はおそらく個人の左目の虹彩です。

PupilCenter_1

登録する個人の生徒の一人の中心の位置。虹彩認識システムが 1 つの目のみを監視している場合、この位置はその目の瞳孔の中心になります。虹彩認識システムが両方の目を監視しているが、1 つの目だけがカメラフレーム内にある場合、この位置はカメラフレーム内の瞳孔の中心になります。虹彩認識システムが両方の目を監視していて、両方の目がカメラフレームにある場合、この位置はおそらく個人の右目の瞳孔の中心です。

PupilCenter_2

登録する個人の生徒の一人の中心の位置。虹彩認識システムが 1 つの目のみを監視している場合、または 1 つの目だけがカメラフレーム内にある場合、この値は空です。虹彩認識システムが両方の目を監視していて、両方の目がカメラフレームにある場合、この位置はおそらく個人の左目の瞳孔の中心です。

距離

虹彩の実際の位置と虹彩の理想的な焦点距離の間の距離。この値の範囲は -100 ~ 100 です。 0 は理想的な距離を示し、正の値は虹彩の実際の位置が遠すぎることを示し、負の値は実際の位置が近すぎることを示します。

音声

音声パターンで進行中の登録の状態に関する情報。

Reserved: 予約済み。

必要条件

要件	値
サポートされている最小のクライアント	Windows 10 [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows Server 2016 [デスクトップアプリのみ]
Header	Winbio_types.h (クライアントアプリケーションの場合は Winbio.h、アダプターの場合は Winbio_adapters.h を含む)

次の方法で共有

WINBIO_EXTENDED_ENROLLMENT_STATUS構造体

構文

メンバー

必要条件

フィードバック

その他のリソース