KSPROPERTY_CAMERACONTROL_EXTENDED_OPTIMIZATIONHINT (Strategie für die Anwendungsleistung)

Kameratreiber können ihren Aufnahmevorgang basierend auf den von der Anwendung bereitgestellten Hinweisen optimieren. Diese Eigenschaft informiert den Treiber, seine Leistungsstrategie basierend auf dem wahrscheinlich am häufigsten verwendeten Vorgang festzulegen. Wenn er beispielsweise für Foto optimiert ist, kann der Kameratreiber den Sensor programmieren, um die Sensorbelichtungsgeschwindigkeit und -auflösung zu optimieren, um eine geringere Latenz zwischen Fotoaufnahmetrigger und Bildaufnahme zu verringern. Ebenso kann der Kameratreiber, wenn er für Video optimiert ist, den Sensor für eine höhere Bildfrequenz, aber mit einer niedrigeren Auflösung programmieren.

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.

Der Funktionsmembervon KSCAMERA_EXTENDEDPROP_HEADER enthält eine bitweise OR-Kombination aus mindestens einem der folgenden Optimierungshinweise.

Optimierungshinweis	BESCHREIBUNG
KSCAMERA_EXTENDEDPROP_OPTIMIZATION_PHOTO	Kamerabetrieb ist für Fotos optimiert
KSCAMERA_EXTENDEDPROP_OPTIMIZATION_VIDEO	Kamerabetrieb ist für Video optimiert

Das Flags-Elementvon KSCAMERA_EXTENDEDPROP_HEADER enthält die derzeit für die Kamera festgelegte Optimierung (ein Wert).

Der Standardoptimierungstyp ist KSCAMERA_EXTENDEDPROP_OPTIMIZATION_PHOTO. Wenn diese Eigenschaft vom Kameratreiber unterstützt wird, müssen beide Optimierungstypen unterstützt werden.

Dieses Eigenschaftssteuerelement ist synchron und nicht abbruchfähig.

Hinweise

Optimierungsmodi

KSCAMERA_EXTENDEDPROP_OPTIMIZATION_PHOTO

Alle Kameratreiber müssen sich in diesem Modus befinden, bis sie explizit darüber informiert sind, den KSCAMERA_EXTENDEDPROP_OPTIMIZATION_VIDEO Modus zu verwenden. Der Zweck dieses Modus besteht darin, die Kamerahardware für Fotovorgänge zu optimieren. Videovorgänge müssen in diesem Modus weiterhin funktionsfähig sein.

KSCAMERA_EXTENDEDPROP_OPTIMIZATION_VIDEO

Dieser Modus gibt an, dass die Kamera wahrscheinlich für Videovorgänge verwendet wird. Der Kameratreiber sollte die Hardware für Videovorgänge für diesen Modus optimieren. Fotovorgänge müssen funktionsfähig sein, aber die Ressourcennutzungspriorität gilt für Videovorgänge.

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 Optimierungswerte
Flags	Die aktuelle Optimierungswerteinstellung

Wenn zuvor kein Optimierungsmodus festgelegt wurde, legt der Treiber Flags auf KSCAMERA_EXTENDEDPROP_OPTIMIZATION_PHOTO (Standard) fest.

Festlegen der Eigenschaft

Wenn die -Eigenschaft festgelegt ist, eine KSPROPERTY_TYPE_SET Anforderung, enthält das Flags-Element von KSCAMERA_EXTENDEDPROP_HEADER den festzulegenden Optimierungsmodus.

Anforderungen

Version: Verfügbar ab Windows 8.1

Header: Ksmedia.h (include Ksmedia.h)

Weitere Informationen

KSCAMERA_EXTENDEDPROP_HEADER

KSCAMERA_EXTENDEDPROP_VALUE