KSPROPERTY_CAMERACONTROL_EXTENDED_FACEAUTH_MODE

  • Artikel

KSPROPERTY_CAMERACONTROL_EXTENDED_FACEAUTH_MODE ist eine Eigenschaften-ID, die zum Aktivieren und Deaktivieren der Gesichtsauthentifizierung verwendet wird.

Nutzungszusammenfassungstabelle

`Scope` Control type

Version 1

Pin

Synchron

Die folgenden Bitflags steuern die Gesichtsauthentifizierung im Treiber:

#define KSCAMERA_EXTENDEDPROP_FACEAUTH_MODE_DISABLED                        0x0000000000000001
#define KSCAMERA_EXTENDEDPROP_FACEAUTH_MODE_ALTERNATIVE_FRAME_ILLUMINATION  0x0000000000000002
#define KSCAMERA_EXTENDEDPROP_FACEAUTH_MODE_BACKGROUND_SUBTRACTION          0x0000000000000004

In der folgenden Tabelle werden die Flagfunktionen beschrieben:

Flag Beschreibung

KSCAMERA_EXTENDEDPROP_FACEAUTH_MODE_DISABLED

Optionale Funktion.

Wenn angegeben, ist der Video-Gesichtserkennungsmodus im Treiber deaktiviert. Dieses Flag schließt sich gegenseitig mit den KSCAMERA_EXTENDEDPROP_FACEAUTH_MODE_BACKGROUND_SUBTRACTION - und KSCAMERA_EXTENDEDPROP_FACEAUTH_MODE_ALTERNATIVE_FRAME_ILLUMINATION-Flags aus.

KSCAMERA_EXTENDEDPROP_FACEAUTH_MODE_ALTERNATIVE_FRAME_ILLUMINATION

Obligatorische Funktion, wenn KSCAMERA_EXTENDEDPROP_FACEAUTH_MODE_BACKGROUND_SUBTRACTION nicht unterstützt wird.

Bei Angabe ist es obligatorisch, KSCAMERA_EXTENDEDPROP_FACEAUTH_MODE_ALTERNATIVE_FRAME_ILLUMINATION für jedes Beispiel festzulegen, wie in den Framemetadaten beschrieben. Dieses Flag schließt sich gegenseitig mit den KSCAMERA_EXTENDEDPROP_FACEAUTH_MODE_BACKGROUND_SUBTRACTION - und KSCAMERA_EXTENDEDPROP_FACEAUTH_MODE_DISABLED-Flags aus. In diesem Modus wird erwartet, dass der IR-Stroboskop für jeden erfassten Frame ein-/auswechselt.

KSCAMERA_EXTENDEDPROP_FACEAUTH_MODE_BACKGROUND_SUBTRACTION

Obligatorische Funktion, wenn KSCAMERA_EXTENDEDPROP_FACEAUTH_MODE_ALTERNATIVE_FRAME_ILLUMINATION nicht unterstützt wird.

Dieses Flag schließt sich gegenseitig mit den KSCAMERA_EXTENDEDPROP_FACEAUTH_MODE_ALTERNATIVE_FRAME_ILLUMINATION - und KSCAMERA_EXTENDEDPROP_FACEAUTH_MODE_DISABLED-Flags aus. In diesem Modus wird erwartet, dass ein IR-Bild mit subtrahiertem HINTERGRUND-IR-Licht erstellt wird.

Standardmäßig sollte der Treiber KSPROPERTY_CAMERACONTROL_EXTENDED_FACEAUTH_MODE auf KSCAMERA_EXTENDEDPROP_FACEAUTH_MODE_DISABLED festgelegt haben, wenn es sich um eine universelle IR-Kamera handelt. Andernfalls sollte er auf KSCAMERA_EXTENDEDPROP_FACEAUTH_MODE_BACKGROUND_SUBTRACTION oder KSCAMERA_EXTENDEDPROP_FACEAUTH_MODE_ALTERNATIVE_FRAME_ILLUMINATION festgelegt werden.

IR-Kameras sollten für KSCAMERA_EXTENDEDPROP_FACEAUTH_MODE_DISABLED werben, wenn erwartet wird, dass sie für allgemeine Szenarien neben Windows Hello funktionieren.

Ir-Kameras, die für die Gesichtsanmeldung verwendet werden, sollten entweder KSCAMERA_EXTENDEDPROP_FACEAUTH_MODE_ALTERNATIVE_FRAME_ILLUMINATION oder KSCAMERA_EXTENDEDPROP_FACEAUTH_MODE_BACKGROUND_SUBTRACTION-Funktion unterstützen, sie sollten nur eines dieser Flags unterstützen, nicht beide.

Die folgende Tabelle enthält die Beschreibungen und Anforderungen für die KSCAMERA_EXTENDEDPROP_HEADER Strukturfelder bei Verwendung des Steuerelements.

Member BESCHREIBUNG

Version

Dies muss 1 sein.

PinId

Darf nur auf einem Pin des Filters angekündigt werden. Der Pin muss vom Typ PINNAME_VIDEO_CAPTURE oder PINNAME_VIDEO_PREVIEW sein, IR-Sensordaten erzeugen und als freigegeben für FrameServer gekennzeichnet sein.

Size

Dies muss sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING) sein.

Ergebnis

Gibt die Fehlerergebnisse des letzten SET-Vorgangs an. Wenn kein SET-Vorgang durchgeführt wurde, muss dies 0 sein.

Funktion

Muss ein bisschen weise sein ODER der unterstützten KSCAMERA_EXTENDEDPROP_ FACEAUTH_MODE_xxx Flags wie oben definiert.

Der Treiber sollte nicht KSCAMERA_EXTENDEDPROP_FACEAUTH_MODE_ALTERNATIVE_FRAME_ILLUMINATION und KSCAMERA_EXTENDEDPROP_FACEAUTH_MODE_BACKGROUND_SUBTRACTION

Flags

Dies ist ein Lese-/Schreibfeld. Dies kann eines der oben definierten KSCAMERA_EXTENDEDPROP_ FACEAUTH_MODE_xxx Flags sein.

Anforderungen

Header

 Ksmedia.h