KSPROPERTY_CAMERACONTROL_EXTENDED_FIELDOFVIEW2_CONFIGCAPS

Artikel
06/25/2024

KSPROPERTY_CAMERACONTROL_EXTENDED_FIELDOFVIEW2_CONFIGCAPS ist eine Eigenschafts-ID, die es Kameratreibern ermöglicht, mehrere feste Sichtfeldeinstellungen (FoV) anzubieten, die Benutzer über die Kameraeinstellungsseite oder über Anwendungen auswählen können.

Das im KSPROPERTY_CAMERACONTROL_EXTENDED_FIELDOFVIEW2_CONFIGCAPS-Nutzlastarray gemeldete Feld der Ansichtswerte muss in absteigender Reihenfolge sortiert werden, z. B. den größten Wert zuerst.
Alle von KSPROPERTY_CAMERACONTROL_EXTENDED_FIELDOFVIEW2_CONFIGCAPS gemeldeten Field of View (FoV)-Werte müssen für alle verfügbaren Medientypen unterstützt werden, die der Treiber unterstützt.
- Treiber können eine Skalierung und/oder ein Zuschneiden vornehmen, um FOVs bei bestimmten Auflösungen zu erzielen.
- Ausnahmen können gemacht werden, indem Kameraprofile unterstützt und KSPROPERTY_CAMERACONTROL_EXTENDED_FIELDOFVIEW2 als BlockedControl hinzugefügt werden. Dies führt dazu, dass das FIELDOFVIEW2-Steuerelement überhaupt nicht unterstützt wird, wenn ein Profil verwendet wird, das es blockiert.

Übersichtstabelle zur Verwendung

Bereich	Abrufen	Festlegen	Control	type
Version 1	Ja	No	Filter	Synchron

KSCAMERA_EXTENDEDPROP_HEADER-Strukturfelder

Die folgende Tabelle enthält die Anforderungen für die KSCAMERA_EXTENDEDPROP_HEADER-Strukturfelder bei Verwendung des Steuerelements.

Member	Beschreibung
Version	Muss 1 sein.
PinId	KSCAMERA_EXTENDEDPROP_FILTERSCOPE (0xFFFFFFFF)
Size	Dies muss sizeof(KSCAMERA_EXTENDEDPROP_HEADER)+sizeof(KSCAMERA_EXTENDEDPROP_FIELDOFVIEW2_CONFIGCAPS) sein.
Ergebnis	Muss 0 enthalten. Dieses Feld wird nur verwendet, um die Ergebnisse des letzten asynchronen SET-Vorgangs zurückzugeben.
Funktion	Muss den Wert 0 (null) haben.
Flags	Muss den Wert 0 (null) haben.

KSPROPERTY_CAMERACONTROL_EXTENDED_FIELDOFVIEW2_CONFIGCAPS-Payload

Die auf die Headerstruktur folgende Payload ist die obligatorische KSCAMERA_EXTENDEDPROP_FIELDOFVIEW2_CONFIGCAPS.

Parameter	Beschreibung
DefaultDiagonalFieldOfViewInDegrees	Der Field of View (FoV)-Standardwert. Muss einer der im DiscreteFoVStops-Array gemeldeten Werte sein.
DiscreteFoVStopsCount	Anzahl der gültigen Einträge in DiscreteFovStops, maximal 360, mindestens 1.
DiscreteFoVStops	Array gültiger Field of View (FoV)-Stopps, nur DiscreteFoVStopsCount sind gültige Elemente.
Reserviert	Legen Sie auf 0 fest.