KSPROPERTY_CAMERACONTROL_EXTENDED_VIDEOHDR
KSPROPERTY_CAMERACONTROL_EXTENDED_VIDEOHDR wird verwendet, um HDR-Videos (High Dynamic Range) auf dem Treiber zu aktivieren oder zu deaktivieren. Dies ist ein Pin-Level-Steuerelement, das nur für Video-Pins verwendet werden kann.
Tabelle "Nutzungszusammenfassung"
| Herunterladen | Set | Ziel | Eigenschaftendeskriptortyp |
|---|---|---|---|
| Ja | Ja | Pin | KSPROPERTY_CAMERACONTROL_EXTENDED_VIDEOHDR |
Die folgenden Flags können im KSCAMERA_EXTENDEDPROP_HEADER platziert werden. Flags-Feld zum Steuern von Video-HDR. Standardmäßig sollte treiber auf VIDEOHDR_OFF festgelegt sein.
#define KSCAMERA_EXTENDEDPROP_VIDEOHDR_OFF 0x0000000000000000
#define KSCAMERA_EXTENDEDPROP_VIDEOHDR_ON 0x0000000000000001
#define KSCAMERA_EXTENDEDPROP_VIDEOHDR_AUTO 0x0000000000000002
Wenn der Treiber dieses Steuerelement unterstützt, muss er VIDEOHDR_ON/VIDEOHDR_OFF unterstützen.
Wenn der Treiber video-HDR nicht unterstützt, sollte der Treiber dieses Steuerelement nicht implementieren.
Dieses Steuerelement dient dem Treiber als Hinweis. Wenn die Einstellung auf VIDEOHDR_ON festgelegt ist, sollte der Treiber video-HDR als optimale Leistung ausführen.
Der SET-Aufruf dieses Steuerelements hat keine Auswirkung, wenn der Videonadel KSSTATE_RUN Zustand ist. Der Treiber muss den empfangenen SET-Anruf ablehnen, wenn sich der Videopin in einem aktiven Zustand befindet, und gibt STATUS_INVALID_DEVICE_STATE zurück. Bei einem GET-Aufruf sollte der Treiber die aktuellen Einstellungen im Feld Flags zurückgeben.
In der folgenden Tabelle werden die Flagfunktionen beschrieben.
| Flag | Beschreibung |
|---|---|
| KSCAMERA_EXTENDEDPROP_VIDEOHDR_OFF | Dies ist eine obligatorische Funktion. Wenn angegeben, ist das Video HDR im Treiber deaktiviert, und der Treiber darf kein Video-HDR im Videostream ausführen. |
| KSCAMERA_EXTENDEDPROP_VIDEOHDR_ON | Dies ist eine obligatorische Funktion. Wenn angegeben, wird das Video-HDR im Treiber aktiviert, und der Treiber muss Video-HDR als optimale Leistung ausführen. Dieses Flag schließt sich mit den VIDEOHDR_AUTO- und VIDEOHDR_OFF-Flags gegenseitig aus. |
| KSCAMERA_EXTENDEDPROP_VIDEOHDR_AUTO | Diese Funktion ist optional. Bei Angabe bestimmt der Treiber, der diese Funktion unterstützt, basierend auf der Szenenanalyse, ob Video-HDR ausgeführt werden soll. Dieses Flag schließt sich mit den flags VIDEOHDR_ON und VIDEOHDR_OFF gegenseitig aus. |
Die folgende Tabelle enthält die Beschreibungen und Anforderungen für die KSCAMERA_EXTENDEDPROP_HEADER Strukturfelder bei Verwendung des -Steuerelements.
| Member | BESCHREIBUNG |
|---|---|
| Version | Dies muss 1 sein. |
| PinId | Muss die Pin-ID sein, die der Video-Pin zugeordnet ist. |
| Size | Dies muss sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_VALUE) sein. |
| Ergebnis | Gibt die Fehlerergebnisse des letzten SET-Vorgangs an. Wenn kein SET-Vorgang stattgefunden hat, muss dieser 0 sein. |
| Funktion | Muss ein bitweises OR der oben definierten unterstützten KSCAMERA_EXTENDEDPROP_VIDEOHDR_*-Flags sein. |
| Flags | Dies ist ein Lese-/Schreibfeld. Dies kann eines der oben definierten KSCAMERA_EXTENDEDPROP_VIDEOHDR_*-Flags sein. |
Anforderungen
Mindestens unterstützter Client: Windows 11
Header: ksmedia.h (include Ksmedia.h)