PIBIO_ENGINE_IDENTIFY_ALL_FN コールバック関数 (winbio_adapter.h)

Windows 生体認証フレームワークによって呼び出され、現在カメラ フレームに入っているすべてのユーザーの ID を決定します。

構文

PIBIO_ENGINE_IDENTIFY_ALL_FN PibioEngineIdentifyAllFn;

HRESULT PibioEngineIdentifyAllFn(
  [in, out] PWINBIO_PIPELINE Pipeline,
  [out]     PSIZE_T PresenceCount,
  [out]     PWINBIO_PRESENCE *PresenceArray
)
{...}

パラメーター

[in, out] Pipeline

操作を実行する生体認証ユニットに関連付けられている WINBIO_PIPELINE 構造体へのポインター。

[out] PresenceCount

関数によって検出されたプレゼンスの数を受け取る変数のアドレス。

[out] PresenceArray

WINBIO_PRESENCE要素の配列へのポインターを受け取る変数のアドレス。

戻り値

関数が成功した場合は、S_OK を返します。 関数が失敗した場合は、次のいずれかの HRESULT 値を返してエラーを示す必要があります。

リターン コード	説明
E_some_error	エラー コードがあれば、生体認証サービスによってエラーがログに記録され、カメラ フレームが無視されます。

注釈

生体認証サービスは、エンジン アダプターに新しいデータ フレームを送信した後、このメソッドを呼び出します。

データ フレームを処理した後、この関数は、データ フレームで検出されたプレゼンスごとに 1 つの WINBIO_PRESENCE 要素を返す必要があります。

EngineAdapterIdentifyAll 関数がフレーム内の顔を見つけることができない場合は、S_OKの HRESULT を返し、PresenceCount と PresenceArray の戻りパラメーターをそれぞれ 0 と NULL に設定します。 つまり、人間の存在を含まないフレームはエラー状態ではありません。

EngineAdapterIdentifyAll がS_OK以外の HRESULT を返す唯一の時間は、略歴 サービスがフレームを使用してプレゼンス モニターの状態を更新したくない場合です。 これはまれに発生します。 エンジン アダプターは、PresenceArray パラメーターで返WINBIO_PRESENCE要素の配列を割り当てる役割を担います。 HeapAlloc 関数を使用して、プロセス ヒープからこのメモリを割り当てる必要があります。 配列が作成されると、Windows 生体認証フレームワークの プロパティになります。 フレームワークはこのメモリの使用後に割り当てを解除するため、エンジン アダプターは配列の割り当てを解除したり、ポインターを保存したりしないでください。 この規則に従わないと、ヒープが破損し、生体認証サービスがクラッシュする可能性があります。

PresenceArray 内の個々のWINBIO_PRESENCE項目の値によって、クライアント アプリケーションに対して生成されるイベントが決定されます。 詳細については、 WINBIO_PRESENCE 構造の説明を参照してください。

要件

要件	値
サポートされている最小のクライアント	Windows 10 [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2016 [デスクトップ アプリのみ]
対象プラットフォーム	Windows
ヘッダー	winbio_adapter.h (Winbio_adapter.h を含む)