次の方法で共有

WINBIO_EXTENDED_ENROLLMENT_STATUS構造体

  • [アーティクル]

進行中の登録の状態に関する追加情報が含まれます。

構文

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 つの目だけがカメラ フレーム内にある場合、この値は空です。 虹彩認識システムが両方の目を監視していて、両方の目がカメラフレームにある場合、この位置はおそらく個人の左目の虹彩です。

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

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 を含む)