KSPROPERTY_CAMERACONTROL_EXTENDED_FACEAUTH_MODE

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