KSPROPERTY_CAMERACONTROL_EXTENDED_PHOTOMAXFRAMERATE

Diese Eigenschaft stellt die maximale Aufnahmebildrate für eine Kamera bereit, wenn sie sich im Fotosequenzmodus befindet.

Nutzungszusammenfassungstabelle

Herunterladen	Set	Ziel	Eigenschaftsdeskriptortyp	Eigenschaftswerttyp
Yes	Yes	Pin	KSPROPERTY	KSCAMERA_EXTENDEDPROP_HEADER

Der Eigenschaftswert (Vorgangsdaten) enthält eine KSCAMERA_EXTENDEDPROP_HEADER Struktur und eine KSCAMERA_EXTENDEDPROP_VALUE Struktur. Die maximale Fotobildrate in Bildern pro Sekunde wird als Wert in KSCAMERA_EXTENDEDPROP_VALUE festgelegt oder zurückgegeben.

Im Flags-Member von KSCAMERA_EXTENDEDPROP_HEADER für diese Eigenschaft sind keine Flags festgelegt.

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.

Dieses Eigenschaftensteuerelement ist asynchron und kann nicht abgebrochen werden.

Hinweise

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	Die Pin-ID für die Fotonadel.
Size	sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_VALUE)
Ergebnis	Ein Fehlerwert, der sich aus dem Versuch ergibt, die maximale Bildfrequenz zu lesen. Andernfalls ist es 0.
Funktion	KSCAMERA_EXTENDEDPROP_CAPS_ASYNCCONTROL
Flags	0

Der Wert der Bildfrequenz wird im Ratio-Member von KSCAMERA_EXTENDEDPROP_VALUE festgelegt. Ratio.HighPart enthält den Zähler der Bildrate und Ratio.LowPart den Nenner der Bildrate.

Wenn sich der Treiber im Fotosequenzmodus befindet, kann es notwendig sein, die maximale Bildrate der Fotoaufnahme zu begrenzen. Dadurch wird sichergestellt, dass "Moment-in-Time"-Erfassungsszenarien mit einer bestimmten Anzahl von Verlaufsframes innerhalb einer konfigurierten Zeitspanne enthalten sind. Wenn die Anwendung beispielsweise basierend auf Speichereinschränkungen einen Wert von 1 Sekunde des vergangenen Verlaufs erfassen möchte, muss die Erfassungsrate begrenzt werden, sodass nur die Anzahl von Frames benötigt wird.

Wenn festgelegt, muss der Treiber die angegebene Bildfrequenz verwenden, auch wenn die Kamera Frames schnell erfassen kann, dann die angeforderte Rate. Bei Bedarf kann der Treiber zusätzliche Frames löschen, um die angeforderte Rate zu berücksichtigen.

Durch Festlegen des maximalen Bildfrequenzwerts auf 0 (0 für den HighPart und 0 für das Niedrige Teil des Verhältnisses) wird die Einstellung der maximalen Bildfrequenz im Treiber gelöscht und hat den gleichen Effekt wie die Aufforderung an den Treiber, Frames so schnell wie möglich bereitzustellen. Sobald die Bildrate auf 0 festgelegt ist, gibt jede nachfolgende Abfrage den Wert der maximalen Bildrate zurück, die für den Kameratreiber möglich ist.

Requirements (Anforderungen)

Version	Verfügbar ab Windows 8.1.
Header	Ksmedia.h (include Ksmedia.h)