KSPROPERTY_CAMERACONTROL_EXTENDED_FRAMERATE_THROTTLE
KSPROPERTY_CAMERACONTROL_EXTENDED_FRAMERATE_THROTTLE ist eine dynamische Steuerung, die die Bildrate des Videos um einen Skalierungsfaktor der ursprünglichen Bildrate reduziert.
Übersichtstabelle zur Verwendung
| Abrufen | Festlegen | Ziel | Eigenschaftendeskriptortyp | Eigenschaftswerttyp |
|---|---|---|---|---|
| Ja | Ja | Filter | KSPROPERTY | KSCAMERA_EXTENDEDPROP_HEADER |
The property value (operation data) contains a KSCAMERA_EXTENDEDPROP_HEADER structure and a KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING-Struktur.
Die Gesamtgröße der Eigenschaftsdaten beträgt sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING). Das Size-Mitglied von KSCAMERA_EXTENDEDPROP_HEADER ist auf diese Gesamtgröße der Eigenschaftsdaten eingestellt.
Das Capability-Mitglied von KSCAMERA_EXTENDEDPROP_HEADER enthält einen der folgenden Werte.
| Drosselungssteuerung der Bildfrequenz | Beschreibung |
|---|---|
| KSCAMERA_EXTENDEDPROP_FRAMERATE_THROTTLE_OFF | Drosselung der Bildfrequenz ist deaktiviert. |
| KSCAMERA_EXTENDEDPROP_FRAMERATE_THROTTLE_ON | Drosselung der Bildfrequenz ist aktiviert. |
Das Flags-Mitglied von KSCAMERA_EXTENDEDPROP_HEADER enthält das Flag, das derzeit für die Kamera festgelegt ist. KSCAMERA_EXTENDEDPROP_FRAMERATE_THROTTLE_OFF sollte die Standardeinstellung sein.
Dieses Eigenschaftensteuerelement ist synchron und kann nicht abgebrochen werden.
Dieses Steuerelement gilt nur, wenn die Kamera aktiv streamt. Aktives Streaming bedeutet, dass sich ein Vorschau- oder Aufzeichnungs-Pin in KSSTATE_RUN befinden muss, also bereit und in der Lage sein muss, Bilder zu liefern. Wenn Sie festlegen, dass ein Stream nicht aktiv ist, sollte dieses Steuerelement STATUS_INVALID_DEVICE_STATE zurückgeben. Auch wenn es sich hierbei um eine Filterbereichssteuerung handelt, sollte dies keine Auswirkungen auf Photo-Pin- oder Nicht-RGB-Streams wie IR/Tiefe haben.
Hinweise
Abrufen der Eigenschaft
Bei der Beantwortung einer KSPROPERTY_TYPE_GET-Anforderung legt der Treiber die Mitglieder von KSCAMERA_EXTENDEDPROP_HEADER auf Folgendes fest.
| Member | Wert |
|---|---|
| Version | 1 |
| PinId | KSCAMERA_EXTENDEDPROP_FILTERSCOPE (0xFFFFFFFF) |
| Size | Dies muss sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING) sein. |
| Ergebnis | Muss den Wert 0 (null) haben. Dieses Feld wird verwendet, um das Ergebnis des letzten SET-Vorgangs zurückzugeben. |
| Funktion | KSCAMERA_EXTENDEDPROP_FRAMERATE_THROTTLE_ON oder 0x1 |
| Flags | Dies kann entweder KSCAMERA_EXTENDEDPROP_FRAMERATE_THROTTLE_ON oder KSCAMERA_EXTENDEDPROP_FRAMERATE_THROTTLE_OFF sein. |
Wenn zuvor kein Drosselungs-Flag für die Bildfrequenz festgelegt wurde, legt der Treiber Flags auf KSCAMERA_EXTENDEDPROP_FRAMERATE_THROTTLE_OFF fest. Die Mitglieder der KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING-Struktur, die KSCAMERA_EXTENDEDPROP_HEADER befolgen, werden gemäß den Anforderungen des Drosselungsmodus der Bildfrequenz festgelegt.
Festlegen der Eigenschaft
Wenn die Eigenschaft, eine KSPROPERTY_TYPE_SET-Anforderung, festgelegt ist, enthält das Flags-Mitglied von KSCAMERA_EXTENDEDPROP_HEADER den festzulegenden Drosselungsmodus für die Bildfrequenz. Das VideoProc.Value-Mitglied von KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING muss ignoriert werden, wenn Flags das KSCAMERA_EXTENDEDPROP_FRAMERATE_THROTTLE_OFF-Flag enthält.
Nutzlaststruktur
Die folgende Tabelle enthält die Beschreibungen und Anforderungen für die KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING-Strukturfelder für die Drosselungs-DDI der Bildfrequenz. Diese Struktur wird in ksmedia.h definiert.
| Member | Beschreibung |
|---|---|
| Mode | Dies wird nicht verwendet und muss 0 sein. |
| Min/Max/Schritt | Der Maximalwert muss 100 betragen, was bedeutet, dass sich die Bildfrequenz nicht ändert. Der Schritt sollte ein Faktor von 100 sein, sodass Max % Schritt == 0. Min sollte mindestens einer Schrittgröße oder einem Vielfachen der Schrittgröße entsprechen. Min kann nicht 0 sein. |
| VideoProc | Der VideoProc.Value.ul muss den Skalierungsfaktorprozentsatz für dieses Steuerelement angeben. Dieser Wert sollte sich innerhalb des Bereichs von Min und Max befinden, und er sollte auf ein Vielfaches des Schrittwerts festgelegt werden. Wenn Sie diesen Wert entsprechend festlegen, kann eine Anwendung sicherstellen, dass die neue Bildfrequenz niemals den ursprünglichen Wert überschreitet oder zu Null wechselt. Das Festlegen eines Werts von 80 würde beispielsweise eine Bildfrequenz von 80 % der ursprünglichen Bildfrequenz erzeugen. |
| Reserviert | Dies wird nicht verwendet. Dies muss vom Treiber ignoriert werden. |
Anforderungen
Mindestens unterstützter Client: Windows 11, Version 24H2
Header: ksmedia.h (include Ksmedia.h)