Freigeben über


KSPROPERTY_CAMERACONTROL_EXTENDED_ISO_ADVANCED

KSPROPERTY_CAMERACONTROL_EXTENDED_ISO_ADVANCED ist ein erweitertes Eigenschaftensteuerelement, das eine globalere ISO-Steuerung mit mehr Granularität ermöglicht.

Tabelle "Nutzungszusammenfassung"

`Scope` Control type

Version 1

Anheften (Foto)

Asynchron

Das neue KSCAMERA_EXTENDEDPROP_ISO_MANUAL-Flag wird in ksmedia_phone.h wie folgt definiert.

#define KSCAMERA_EXTENDEDPROP_ISO_MANUAL          0x0080000000000000

Die folgende Tabelle enthält die Beschreibungen und Anforderungen für die KSCAMERA_EXTENDEDPROP_HEADER Strukturfelder für das KSPROPERTY_CAMERACONTROL_EXTENDED_ISO_ADVANCED-Steuerelements.

Die Windows 8.1 KS_CAMERACONTROL_EXTENDED_ISO bleibt unverändert, ohne dass die unterstützung von ganzzahliger manueller ISO-Datei unterstützt wird. Der Treiber sollte nur das neue KSPROPERTY_CAMERACONTROL_EXTENDED_ISO_ADVANCED-Steuerelement unterstützen. Wenn beide Steuerelemente unterstützt werden, wird die Pipeline standardmäßig auf das KSPROPERTY_CAMERACONTROL_EXTENDED_ISO_ADVANCED-Steuerelements festgelegt.

Wenn das KSPROPERTY_CAMERACONTROL_EXTENDED_ISO_ADVANCED-Steuerelements unterstützt wird, kann der Treiber nur folgende Funktionen ankündigen.

  • KSCAMERA_EXTENDEDPROP_ISO_AUTO

  • KSCAMERA_EXTENDEDPROP_ISO_MANUAL

  • KSCAMERA_EXTENDEDPROP_CAPS_ASYNCCONTROL

Wenn der Treiber das KSCAMERA_EXTENDEDPROP_ISO_MANUAL-Funktionsflag angibt, muss er auch die unterstützten ISO-Bereiche im Min/Max/Step-Wert der KSCAMERA_EXTENDED_PROP_VIDEOPROCSETTING-Eigenschaft ankündigen. Wenn der Treiber einen Min-Wert von 0 und einen Max-Wert von 0 oder einen Step-Wert von kleiner als 1 angibt, wird das Steuerelement als nicht verwendbar gekennzeichnet und von der Pipeline abgelehnt.

Wenn der Treiber sowohl KSPROPERTY_CAMERACONTROL_EXTENDED_ISO_ADVANCED als auch KSPROPERTY_CAMERACONTROL_EXTENDED_ISO unterstützt, muss der Treiber KSCAMERA_EXTENDEDPROP_ISO_AUTO sowohl für KSPROPERTY_CAMERACONTROL_EXTENDED_ISO_ADVANCED als auch für KSPROPERTY_CAMERACONTROL_EXTENDED_ISO ankündigen. Andernfalls werden beide ISO-Steuerelemente als nicht verwendbar gekennzeichnet und von der MF-Pipeline abgelehnt.

Wenn der Treiber KSCAMERA_EXTENDEDPROP_ISO_MANUAL in KSPROPERTY_CAMERACONTROL_EXTENDED_ISO_ADVANCED und die numerischen KSCAMERA_EXTENDEDPROP_ISO_XXX-Werte in KSPROPERTY_CAMERACONTROL_EXTENDED_ISO angibt, sollten sich die in KSPROPERTY_CAMERACONTROL_EXTENDED_ISO angekündigten numerischen KSCAMERA_EXTENDEDPROP_ISO_XXX Werte in den unterstützten manuellen ISO-Bereichen enthalten, die von KSCAMERA_EXTENDEDPROP_ISO_MANUAL angekündigt werden. Darüber hinaus sollten alle numerischen KSCAMERA_EXTENDEDPROP_ISO_XXX-Werte in den unterstützten manuellen Bereichen von KSPROPERTY_CAMERACONTROL_EXTENDED_ISO angekündigt werden. Andernfalls können beide ISO-Steuerelemente als nicht verwendbar gekennzeichnet und von der MF-Pipeline abgelehnt werden.

Beispielsweise können Funktionen einer der folgenden Elemente als schwerwiegender Fehler behandelt werden, und die Steuerung kann von der MF-Pipeline abgelehnt werden.

  • KSCAMERA_EXTENDEDPROP_ISO_MANUAL (min= 40, max = 240, step = 20), KSCAMERA_EXTENDEDPROP_ISO_50

  • KSCAMERA_EXTENDEDPROP_ISO_MANUAL (min= 40, max = 240, step = 20), KSCAMERA_EXTENDEDPROP_ISO_80

  • KSCAMERA_EXTENDEDPROP_ISO_MANUAL (min= 40, max = 240, step = 20), KSCAMERA_EXTENDEDPROP_ISO_400

Funktionen der folgenden Werden von der MF-Pipeline akzeptiert.

  • KSCAMERA_EXTENDEDPROP_ISO_MANUAL (min= 40, max = 240, step = 20), KSCAMERA_EXTENDEDPROP_ISO_80, KSCAMERA_EXTENDEDPROP_ISO_100, KSCAMERA_EXTENDEDPROP_ISO_200

  • KSCAMERA_EXTENDEDPROP_ISO_MANUAL (min= 40, max = 240, Step = 20)

  • KSCAMERA_EXTENDEDPROP_ISO_80, KSCAMERA_EXTENDEDPROP_ISO_200

Member BESCHREIBUNG

Version

Dies muss 1 sein,

PinId

Dies muss die Pin-ID sein, die der Fotonadel zugeordnet ist.

Size

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

Ergebnis

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

Funktion

Dies muss ein bisschen weise sein oder KSCAMERA_EXTENDEDPROP_ISO_AUTO und\oder KSCAMERA_EXTENDEDPROP_ISO_MANUAL und das KSCAMERA_EXTENDEDPROP_CAPS_ASYNCCONTROL Flag. Dieses Steuerelement muss asynchron sein.

Flags

Dies ist ein Lese-/Schreibfeld. Dies kann jedes der oben definierten KSCAMERA_EXTENDEDPROP_ISO_XXX Flags sein.

Die folgende Tabelle enthält die Beschreibungen und Anforderungen für die KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING Strukturfelder für den ISO DDI. Diese Struktur ist in ksmedia.h definiert.

Member BESCHREIBUNG

Mode

Dies ist nicht verwendet und muss 0 sein.

Min/Max/Step

Min/Max/Step enthält das Minimum/Maximum/Inkrement der manuellen ISO-Geschwindigkeit, die vom Kameratreiber unterstützt wird. Der Treiber muss diese für GET-Vorgänge zurückgeben, wenn manuelle ISO unterstützt wird.

VideoProc

Wenn MANUAL im Feld Flags des KSCAMERA_EXTENDEDPROP_HEADER angegeben ist, muss videoProc.Value.ul den aktuellen ISO-Geschwindigkeitswert innerhalb des durch den Min/Max/Step-Parameter beschriebenen Bereichs angeben.

Wenn andere Flags als Manuell angegeben sind, wird das VideoProc-Feld für SET-Vorgänge ignoriert. Bei GET-Vorgängen muss der Treiber unabhängig davon immer die aktuelle ISO-Geschwindigkeit zurückgeben.

Reserviert

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

GET-Anruf

Der Treiber muss seine Funktion in KSCAMERA_EXTENDEDPROP_HEADER ankündigen. Funktion und das aktuelle ISO-Flag am Treiber in KSCAMERA_EXTENDEDPROP_HEADER. Flags.â Wenn vor dem Aufruf "Abrufen" noch kein SET-Aufruf ausgegeben wurde, sollte der Treiber den Standardwert in KSCAMERA_EXTENDEDPROP_HEADER zurückgeben. Flaggen.

Wenn das KSCAMERA_EXTENDEDPROP_ISO_MANUAL-Flag im Feld Funktion angekündigt wird, muss der Treiber die unterstützten Bereiche in KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING weiter ankündigen. Min/Max/Step.

Der Treiber muss auch die aktuelle ISO-Geschwindigkeit in KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING melden. VideoProc.Value.ul. Wenn vor dem GET-Aufruf noch kein SET-Aufruf ausgegeben wurde, sollte der Treiber seine aktuelle ISO-Geschwindigkeit in KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING zurückgeben. VideoProc.Value.ul.

SET-Aufruf

Die KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING. VideoProc.Value.ul enthält die gewünschte ganzzahlige manuelle ISO-Geschwindigkeit, wenn KSCAMERA_EXTENDEDPROP_ISO_MANUAL in KSCAMERA_EXTENDEDPROP_HEADER angegeben ist. Flaggen.

Wenn das KSCAMERA_EXTENDEDPROP_ISO_AUTO-Flag in KSCAMERA_EXTENDEDPROP_HEADER angegeben ist. Flags, KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING. VideoProc.Value.ul wird ignoriert.

Anforderungen

Header

Ksmedia.h