KSPROPERTY_CAMERACONTROL_EXTENDED_FLASHMODE (Normal und Sequenz)

Das Flash-Eigenschaftssteuerelement legt den Blitzmodusbetrieb sowohl für den normalen als auch für den Sequenzfotomodus der Kamera fest.

Tabelle "Nutzungszusammenfassung"

Herunterladen	Set	Ziel	Eigenschaftsdeskriptortyp	Eigenschaftswerttyp
Yes	Yes	Filter	KSPROPERTY	KSCAMERA_EXTENDEDPROP_HEADER

Der Eigenschaftswert (Vorgangsdaten) enthält eine KSCAMERA_EXTENDEDPROP_HEADER Struktur und eine KSCAMERA_EXTENDEDPROP_VALUE Struktur.

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

Das Featureelementvon KSCAMERA_EXTENDEDPROP_HEADER enthält eine bitweise OR-Kombination aus mindestens einem der folgenden Flashmodi, die vom Treiber unterstützt werden.

Blitzmodus	BESCHREIBUNG
KSCAMERA_EXTENDEDPROP_FLASH_OFF	Der Blitz ist ausgeschaltet.
KSCAMERA_EXTENDEDPROP_FLASH_ON	Der Blitz ist auf der Standardintensitätsstufe aktiviert.
KSCAMERA_EXTENDEDPROP_FLASH_ON_ADJUSTABLEPOWER	Der Blitz ist bei einer bestimmten Leistungsstufe eingeschaltet.
KSCAMERA_EXTENDEDPROP_FLASH_AUTO	Der Blitz erfolgt automatisch basierend auf den Lichtverhältnissen.
KSCAMERA_EXTENDEDPROP_FLASH_AUTO_ADJUSTABLEPOWER	Der Blitz erfolgt automatisch basierend auf den Lichtverhältnissen bei einer bestimmten Leistungsstufe.

Die folgenden Featureflags können mit den vorherigen Blitzeinstellungen kombiniert werden, mit Ausnahme von KSCAMERA_EXTENDEDPROP_FLASH_OFF.

Flash-Funktion	BESCHREIBUNG
KSCAMERA_EXTENDEDPROP_FLASH_REDEYEREDUCTION	Aktivieren Sie die Redeye-Reduzierungsfunktion. Dieses Flag kann mit jeder anderen Einstellung kombiniert werden.
KSCAMERA_EXTENDEDPROP_FLASH_SINGLEFLASH	Legen Sie den Blitz nur für einen Trigger fest. Dieses Feature wird ignoriert, wenn sich die Kamera nicht im Fotosequenzmodus befindet.
KSCAMERA_EXTENDEDPROP_FLASH_MULTIFLASHSUPPORTED	Legen Sie den Blitz so fest, dass er für jeden Sequenzrahmen ausgelöst wird. Dieses Feature wird ignoriert, wenn sich die Kamera nicht im Fotosequenzmodus befindet.

Das Flags-Elementvon KSCAMERA_EXTENDEDPROP_HEADER enthält den derzeit für die Kamera festgelegten Blitzmodus.

Der Standardblitzmodus für eine Kamera ist KSCAMERA_EXTENDEDPROP_FLASH_OFF. Wenn die Kamera Blitzmodus unterstützt, sind KSCAMERA_EXTENDEDPROP_FLASH_OFF, KSCAMERA_EXTENDEDPROP_FLASH_ON und KSCAMERA_EXTENDEDPROP_FLASH_AUTO erforderlich. Die KSCAMERA_EXTENDEDPROP_FLASH_AUTO_ADJUSTABLEPOWER- und KSCAMERA_EXTENDEDPROP_FLASH_AUTO_ADJUSTABLEPOWER-Modi sind optional.

Wenn der Fotosequenzmodus von der Kamera unterstützt wird, ist die Blitzsteuerungseigenschaft mit Unterstützung für KSCAMERA_EXTENDEDPROP_FLASH_SINGLEFLASH erforderlich.

Dieses Eigenschaftssteuerelement ist synchron und nicht abbruchfähig.

Hinweise

Abrufen der Eigenschaft

Wenn er auf eine KSPROPERTY_TYPE_GET-Anforderung antwortet, legt der Treiber die Member der KSCAMERA_EXTENDEDPROP_HEADER wie folgt fest.

Mitglied	Wert
Version	1
PinId	KSCAMERA_EXTENDEDPROP_FILTERSCOPE (0xFFFFFFFF)
Size	sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_VALUE)
Ergebnis	0
Funktion	Unterstützte Flashmoduswerte
Flags	(Die aktuelle Werteinstellung für den Blitzmodus) | (Blinkfunktionsflags)

Wenn der Taschenlampenmodus KSCAMERA_EXTENDEDPROP_FLASH_ON_ADJUSTABLEPOWER oder KSCAMERA_EXTENDEDPROP_FLASH_ON_ADJUSTABLEPOWER ist, enthält das Value.ull-Element von KSCAMERA_EXTENDEDPROP_VALUE einen Intensitätsgradwert zwischen 0 und 100. Eine Intensität von 0 gibt einen Minimalpegel und eine Intensität von 100 einen maximalen Intensitätsgrad an. Wenn die einstellbaren Leistungsflags nicht festgelegt sind, wird der Wert für die normalisierte Intensitätseinstellung in Value.ull zurückgegeben.

Wenn zuvor kein Blitzmodus festgelegt wurde, wird Flags auf KSCAMERA_EXTENDEDPROP_FLASH_OFF (Standard) festgelegt.

Festlegen der Eigenschaft

Wenn die -Eigenschaft festgelegt ist, eine KSPROPERTY_TYPE_SET Anforderung, enthält das Flags-Element von KSCAMERA_EXTENDEDPROP_HEADER den festzulegenden Taschenlampenmodus. Das Value.ull-Element von KSCAMERA_EXTENDEDPROP_VALUE enthält die Intensitätsstufe , die festgelegt werden soll, wenn Flags KSCAMERA_EXTENDEDPROP_FLASH_ON_ADJUSTABLEPOWER oder KSCAMERA_EXTENDEDPROP_FLASH_AUTO_ADJUSTABLEPOWER ist.

Anforderungen

Version: Verfügbar ab Windows 8.1

Header: Ksmedia.h (include Ksmedia.h)

Weitere Informationen

KSCAMERA_EXTENDEDPROP_HEADER

KSCAMERA_EXTENDEDPROP_VALUE