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