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)