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)