KSPROPERTY_CAMERACONTROL_EXTENDED_IRTORCHMODE

Diese erweiterte Eigenschaftssteuerung wird vom Client verwendet, um den Leistungspegel und den Arbeitszyklus der Infrarotlampe einer IR-Kamera zu steuern. Es wird zusammen mit einer Standard-KSCAMERA_EXTENDEDPROP_HEADER-Struktur gefolgt von einer KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING-Struktur an den Treiber gesendet.

Nutzungszusammenfassungstabelle

Herunterladen	Set	Ziel	Eigenschaftsdeskriptortyp	Eigenschaftswerttyp
Yes	Yes	Filter	KSPROPERTY	KSCAMERA_EXTENDEDPROP_HEADER

Hinweise

Die Eigenschaftsanforderung enthält eine KSCAMERA_EXTENDEDPROP_HEADER-Struktur und eine KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING-Struktur .

Die Gesamtgröße der Eigenschaftsdaten ist sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING). Das Size-Element von KSCAMERA_EXTENDEDPROP_HEADER ist auf diese Gesamtdatengröße der Eigenschaft festgelegt.

Im Folgenden finden Sie Flags, die im KSCAMERA_EXTENDEDPROP_HEADER platziert werden können . Flags und KSCAMERA_EXTENDEDPROP_HEADER. Funktionsfelder . Sie definieren die Betriebsmodi der IR-Taschenlampe.

Taschenlampenmodus	BESCHREIBUNG
KSCAMERA_EXTENDEDPROP_IRTORCHMODE_OFF	Aus
KSCAMERA_EXTENDEDPROP_IRTORCHMODE_ALWAYS_ON	Immer aktiv
KSCAMERA_EXTENDEDPROP_IRTORCHMODE_ALTERNATING_FRAME_ILLUMINATION	Ein für jeden anderen Frame

KSCAMERA_EXTENDEDPROP_IRTORCHMODE ist immer ein synchrones Steuerelement. Das Steuerelement hat kein definiertes Verhalten, wenn die Kamera nicht gestreamt wird.

Für eine GET-Anforderung legt ein Treiber die folgenden Felder fest:

• KSCAMERA_EXTENDEDPROP_HEADER. Funktion mit einer Bitmaske der oben genannten KSCAMERA_EXTENDEDPROP_IRTORCHMODE_XXX-Flags , die die von der Kamera unterstützten Betriebsmodi darstellen.
• KSCAMERA_EXTENDEDPROP_HEADER. Kennzeichnet eines der oben genannten KSCAMERA_EXTENDEDPROP_IRTORCHMODE_XXX-Flags , um den aktuellen Betriebsmodus anzugeben.
• KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING. Modus auf 0.
• KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING. Mindestens bis zum verfügbaren Mindestleistungslevel.
• KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING. Max bis zum maximal verfügbaren Leistungsniveau.
• KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING. Schritt bis zum Mindestschritt zwischen den Leistungsstufen.
• KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING. VideoProc.ul auf die aktuelle Leistungsstufe. Dieser Wert sollte standardmäßig auf den gleichen Leistungsgrad festgelegt werden, der normalerweise vom Steuerelement für die Gesichtsauthentifizierung verwendet wird.

Für eine SET-Anforderung verwendet ein Treiber die folgenden Felder:

• KSCAMERA_EXTENDEDPROP_HEADER. Flags zum Festlegen eines Betriebsmodus.
• KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING. VideoProc.ul , um einen Leistungspegel festzulegen. Dieser Wert hat keine Auswirkungen auf KSCAMERA_EXTENDEDPROP_IRTORCHMODE_OFF.

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

Member	BESCHREIBUNG
Version	Dies muss 1 sein.
PinId	KSCAMERA_EXTENDEDPROP_FILTERSCOPE (0xFFFFFFFF).
Size	Dies muss sizeof(KSCAMERA_EXTENDEDPROP_HEADER)+sizeof([KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING](/windows-hardware/drivers/ddi/ksmedia/ns-ksmedia-tagkscamera_extendedprop_videoprocsetting)) sein.
Ergebnis	Dieser Wert wird für synchrone Steuerelemente ignoriert.
Funktion	Kann eine beliebige Kombination aus KSCAMERA_EXTENDEDPROP_IRTORCHMODE_OFF, KSCAMERA_EXTENDEDPROP_IRTORCHMODE_ALWAYS_ON oder KSCAMERA_EXTENDEDPROP_IRTORCHMODE_ALTERNATIVE_FRAME_ILLUMINATION sein. Dieses Feld muss mindestens eine Funktion melden. Das Feld muss entweder KSCAMERA_EXTENDEDPROP_IRTORCHMODE_ALWAYS_ON oder KSCAMERA_EXTENDEDPROP_IRTORCHMODE_ALTERNATIVE_FRAME_ILLUMINATION oder beides melden. Der Wert KSCAMERA_EXTENDEDPROP_IRTORCHMODE_OFF ist optional.
Flags	Muss eines der Flags sein, die unter Funktion gemeldet werden. Der Standardwert muss entweder KSCAMERA_EXTENDEDPROP_IRTORCHMODE_ALWAYS_ON oder KSCAMERA_EXTENDEDPROP_IRTORCHMODE_ALTERNATIVE_FRAME_ILLUMINATION sein.

Die folgende Tabelle enthält die Beschreibungen und Anforderungen für die KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING Strukturfelder bei Verwendung des IR-Brennermodus-Steuerelements.

Member	BESCHREIBUNG
Mode	Nicht verwendet. Muss den Wert 0 (null) haben.
Min/Max/Step	Min/Max/Step enthält das Minimum/Maximum/Inkrement der IR-Energieeinstellungen. Der Treiber muss diese für GET-Vorgänge zurückgeben. (Max – Min) muss gleichmäßig nach Schritt teilbar sein. Der Schritt darf nicht 0 (0) sein.
VideoProc	Bei SET-Vorgängen muss videoProc.Value.ul den Leistungspegel innerhalb des durch den Min/Max/Step-Parameter beschriebenen Bereichs angeben. Bei GET-Vorgängen muss der Treiber die aktuelle Leistungsstufe zurückgeben.
Reserviert	Nicht verwendet. Muss vom Treiber ignoriert werden.

Anforderungen

Header

Ksmedia.h