KSPROPERTY_CAMERACONTROL_EXTENDED_HISTOGRAM

  • Artikel

KSPROPERTY_CAMERACONTROL_EXTENDED_HISTOGRAM ist eine Eigenschafts-ID, die verwendet wird, um die vom Treiber erzeugten Histogrammmetadaten zu steuern. Dies ist ein Pin-Level-Steuerelement nur für den Vorschau-Pin.

Tabelle "Nutzungszusammenfassung"

`Scope` Control type

Version 1

Pin

Synchron

Die folgenden Flags können im KSCAMERA_EXTENDEDPROP_HEADER platziert werden . Flags-Feld zum Steuern der Histogrammmetadaten im Treiber. Der Standardwert ist HISTOGRAM_OFF.

#define KSCAMERA_EXTENDEDPROP_HISTOGRAM_OFF      0x0000000000000000
#define KSCAMERA_EXTENDEDPROP_HISTOGRAM_ON       0x0000000000000001

Dieses Steuerelement muss vor dem KSPROPERTY_CAMERACONTROL_EXTENDED_METADATA-Steuerelement verwendet werden, um sicherzustellen, dass der Metadatenpuffer der richtigen Größe zugeordnet ist.

Bei Festlegung auf HISTOGRAM_OFF darf der Treiber die Histogrammmetadaten nicht auf dem Vorschau-Pin übermitteln. Der Treiber sollte die Größe der Histogrammmetadaten nicht in seine Metadatenpuffergröße einbeziehen.

Bei Festlegung auf HISTOGRAM_ON übermittelt der Treiber die Histogrammmetadaten auf dem Vorschaupin. Der Treiber muss die Größe der Histogrammmetadaten in seine Metadatenpuffergröße einbeziehen.

Wenn der Treiber nicht in der Lage ist, Histogrammmetadaten zu erstellen, sollte der Treiber dieses Steuerelement nicht implementieren. Wenn der Treiber dieses Steuerelement unterstützt, muss er auch KSPROPERTY_CAMERACONTROL_EXTENDED_METADATA-Steuerelement unterstützen.

Der SET-Aufruf dieses Steuerelements hat keine Auswirkung, wenn sich der Vorschaupin in einem zustand befindet, der höher als der KSSTATE_STOP Zustand ist. Der Treiber muss den empfangenen SET-Aufruf ablehnen, wenn sich die Vorschau nicht im Stoppzustand befindet, und gibt STATUS_INVALID_DEVICE_STATE zurück. Bei einem GET-Aufruf sollte der Treiber die aktuellen Einstellungen im Feld Flags zurückgeben.

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 Vorschau-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 den Wert 0 (null) haben.

Flags

Dies ist ein Lese-/Schreibfeld. Dies kann eines der oben definierten KSCAMERA_EXTENDEDPROP_HISTOGRAM_* -Flags sein.

Anforderungen

Header

 Ksmedia.h