KSPROPERTY_CAMERACONTROL_EXTENDED_ZOOM

  • Artikel

KSPROPERTY_CAMERACONTROL_EXTENDED_ZOOM wird zum Steuern des digitalen Zooms verwendet. Es wird in der KSPROPERTY_CAMERACONTROL_EXTENDED_PROPERTY-Enumeration definiert und wird verwendet, um das Zoomverhältnis und den Get-Zoombereich vom Treiber abzurufen und festzulegen. In Windows 10 wird dieses Steuerelement erweitert, um auch einen reibungslosen Zoom zu unterstützen.

Tabelle "Nutzungszusammenfassung"

`Scope` Control type

Version 1

Filter

Synchron

Die folgenden Flags können im KSCAMERA_EXTENDEDPROP_HEADER platziert werden . Flags-Feld , um den reibungslosen Zoom im Vergleich zum direkten Zoom zu steuern. Der Standardwert wird vom Treiber definiert.

#define KSCAMERA_EXTENDEDPROP_ZOOM_DEFAULT  0x0000000000000000
#define KSCAMERA_EXTENDEDPROP_ZOOM_DIRECT   0x0000000000000001
#define KSCAMERA_EXTENDEDPROP_ZOOM_SMOOTH   0x0000000000000002

Wenn der Treiber dieses Steuerelement unterstützt, muss er KSCAMERA_EXTENDEDPROP_ZOOM_DEFAULT unterstützen.

Wenn der Treiber den digitalen Zoom nicht unterstützt, sollte der Treiber dieses Steuerelement nicht implementieren.

In der folgenden Tabelle werden die Flagfunktionen beschrieben.

Flag Beschreibung

KSCAMERA_EXTENDEDPROP_ZOOM_DEFAULT

Dies ist eine obligatorische Funktion. Bei Angabe entscheidet der Treiber, ob ein direkter Zoom oder ein glatter Zoom angewendet werden soll, und zoomt entsprechend auf den in VideoProc.Value.ul angegebenen Zielzoomfaktor. Dieses Flag schließt sich gegenseitig mit den Flags DIRECT und SMOOTH aus.

KSCAMERA_EXTENDEDPROP_ZOOM_DIRECT

Dies ist eine obligatorische Funktion. Bei Angabe zoomt der Treiber so schnell wie möglich auf den in VideoProc.Value.ul angegebenen Zielzoomfaktor. Dieses Flag schließt sich gegenseitig mit dem AUTO- und SMOOTH-Flag aus.

KSCAMERA_EXTENDEDPROP_ZOOM_SMOOTH

Diese Funktion ist optional. Bei Angabe zoomt der Treiber schrittweise auf den in VideoProc.Value.ul angegebenen Zielzoomfaktor. Die Anzahl der Frames, die benötigt werden, um den angegebenen Zoomfaktor zu erreichen, hängt vom Treiber ab. Dieses Flag schließt sich gegenseitig mit dem AUTO- und DIRECT-Flag aus.

Für jeden GET-Aufruf muss der Treiber die aktuellen Zoombereiche melden, die basierend auf aktuellen Konfigurationen oder Setup zulässig sind.

Die folgende Tabelle enthält die Beschreibungen und Anforderungen für die KSCAMERA_EXTENDEDPROP_HEADER Strukturfelder bei Verwendung der KSPROPERTY_CAMERACONTROL_EXTENDED_ZOOM-Eigenschaft .

Member BESCHREIBUNG

Version

Dies muss 1 sein,

PinId

Dies muss KSCAMERA_EXTENDEDPROP_FILTERSCOPE sein (0xFFFFFFFF),

Size

Dies muss sizeof(KSCAMERA_EXTENDEDPROP_HEADER)+sizeof(KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING) sein.

Ergebnis

Dies gibt die Fehlerergebnisse des letzten SET-Vorgangs an. Wenn kein SET-Vorgang durchgeführt wurde, muss dies 0 sein.

Funktion

Muss ein bitweiser OR der oben definierten unterstützten Flags sein.

Flags

Dies ist ein Lese-/Schreibfeld. Dies kann eines der oben definierten unterstützten Flags sein.

Die folgende Tabelle enthält die Beschreibungen und Anforderungen für die KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING Strukturfelder für die eigenschaft KSPROPERTY_CAMERACONTROL_EXTENDED_ZOOM .

Member BESCHREIBUNG

Mode

Dies ist nicht verwendet und muss 0 sein.

Min/Max/Step

Min/Max/Step enthält das Minimum/Maximum/Inkrement des Zoomverhältnisses, das vom Kameratreiber im Q16-Format unterstützt wird. Der Treiber muss diese Werte für GET-Vorgänge zurückgeben.

VideoProc

Für SET-Vorgänge muss videoProc.Value.ul das Zoomverhältnis innerhalb des durch den Min/Max/Step-Parameter beschriebenen Bereichs angeben. Bei GET-Vorgängen muss der Treiber das aktuelle Zoomverhältnis zurückgeben.

Reserviert

Dies ist nicht verwendet. Dies muss vom Treiber ignoriert werden.

Dieses Eigenschaftssteuerelement ist synchron und nicht abbruchfähig.

Anforderungen

Header

 Ksmedia.h