KSPROPERTY_CAMERACONTROL_EXTENDED_FACEAUTH_MODE
KSPROPERTY_CAMERACONTROL_EXTENDED_FACEAUTH_MODE は、顔認証のオンとオフを切り替えるために使用されるプロパティ ID です。
用法の要点テーブル
範囲 | コントロール | Type |
---|---|---|
Version 1 |
ピン留めする |
同期 |
次のビット フラグは、ドライバーの顔認証を制御します。
#define KSCAMERA_EXTENDEDPROP_FACEAUTH_MODE_DISABLED 0x0000000000000001
#define KSCAMERA_EXTENDEDPROP_FACEAUTH_MODE_ALTERNATIVE_FRAME_ILLUMINATION 0x0000000000000002
#define KSCAMERA_EXTENDEDPROP_FACEAUTH_MODE_BACKGROUND_SUBTRACTION 0x0000000000000004
以下の表では、フラグの機能について説明します。
フラグ | 説明 |
---|---|
KSCAMERA_EXTENDEDPROP_FACEAUTH_MODE_DISABLED |
オプションの機能。 指定すると、ドライバーでビデオ顔認証モードが無効になります。 このフラグは、KSCAMERA_EXTENDEDPROP_FACEAUTH_MODE_BACKGROUND_SUBTRACTION と KSCAMERA_EXTENDEDPROP_FACEAUTH_MODE_ALTERNATIVE_FRAME_ILLUMINATION フラグと相互に排他的です。 |
KSCAMERA_EXTENDEDPROP_FACEAUTH_MODE_ALTERNATIVE_FRAME_ILLUMINATION |
KSCAMERA_EXTENDEDPROP_FACEAUTH_MODE_BACKGROUND_SUBTRACTION がサポートされていない場合の必須機能。 指定した場合、フレーム メタデータで説明されているように、各サンプルに KSCAMERA_EXTENDEDPROP_FACEAUTH_MODE_ALTERNATIVE_FRAME_ILLUMINATION を設定する必要があります。 このフラグは、KSCAMERA_EXTENDEDPROP_FACEAUTH_MODE_BACKGROUND_SUBTRACTION と KSCAMERA_EXTENDEDPROP_FACEAUTH_MODE_DISABLED フラグと相互に排他的です。 このモードでは、キャプチャされた各フレームに対して IR ストロブのオン/オフを切り替えます。 |
KSCAMERA_EXTENDEDPROP_FACEAUTH_MODE_BACKGROUND_SUBTRACTION |
KSCAMERA_EXTENDEDPROP_FACEAUTH_MODE_ALTERNATIVE_FRAME_ILLUMINATION がサポートされていない場合の必須機能。 このフラグは、KSCAMERA_EXTENDEDPROP_FACEAUTH_MODE_ALTERNATIVE_FRAME_ILLUMINATION と KSCAMERA_EXTENDEDPROP_FACEAUTH_MODE_DISABLED フラグと相互に排他的です。 このモードでは、背景のアンビエント IR ライトを差し引いた IR イメージを作成します。 |
汎用 IR カメラの場合、既定では、ドライバーは KSPROPERTY_CAMERACONTROL_EXTENDED_FACEAUTH_MODE が KSCAMERA_EXTENDEDPROP_FACEAUTH_MODE_DISABLED に設定されている必要があります。 それ以外の場合は、KSCAMERA_EXTENDEDPROP_FACEAUTH_MODE_BACKGROUND_SUBTRACTION または KSCAMERA_EXTENDEDPROP_FACEAUTH_MODE_ALTERNATIVE_FRAME_ILLUMINATION に設定する必要があります。
Windows Hello 以外の一般的なシナリオで動作することが予想される場合は、IR カメラは、KSCAMERA_EXTENDEDPROP_FACEAUTH_MODE_DISABLED をアドバタイズする必要があります。
顔ログインに使用される IR カメラでは、KSCAMERA_EXTENDEDPROP_FACEAUTH_MODE_ALTERNATIVE_FRAME_ILLUMINATION または KSCAMERA_EXTENDEDPROP_FACEAUTH_MODE_BACKGROUND_SUBTRACTION 機能のいずれかをサポートする必要があります。これらのフラグの両方ではなく、いずれか 1 つだけをサポートする必要があります。
次の表は、KSCAMERA_EXTENDEDPROP_HEADER 構造体フィールドについて、このコントロールを使用する場合の説明と要件を示します。
メンバー | 説明 |
---|---|
Version |
これは 1 である必要があります。 |
PinId |
フィルター上の 1 つのピンでのみアドバタイズする必要があります。 ピンはタイプ PINNAME_VIDEO_CAPTURE または PINNAME_VIDEO_PREVIEW である必要があり、IR センサー データを生成し、FrameServer で共有可能としてマークする必要があります。 |
サイズ |
これは、sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof (KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING) である必要があります。 |
結果 |
最後の SET 操作のエラー結果を示します。 SET 操作が実行されていない場合は、0 にする必要があります。 |
機能 |
上記で定義した、サポートされている KSCAMERA_EXTENDEDPROP_ FACEAUTH_MODE_xxx フラグのビット論理和にする必要があります。 ドライバーは、KSCAMERA_EXTENDEDPROP_FACEAUTH_MODE_ALTERNATIVE_FRAME_ILLUMINATION と KSCAMERA_EXTENDEDPROP_FACEAUTH_MODE_BACKGROUND_SUBTRACTION の両方をアドバタイズしないでください。 |
Flags |
これは読み取り/書き込みフィールドです。 これは、上記で定義した KSCAMERA_EXTENDEDPROP_ FACEAUTH_MODE_xxx フラグのいずれかになります。 |
要件
ヘッダー |
Ksmedia.h |