KSPROPERTY_CAMERACONTROL_EXTENDED_VIDEOHDR

  • Artikel

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)

Weitere Informationen

2.2.2.13 Video-HDR-Steuerelement