KSPROPERTY_CAMERACONTROL_EXTENDED_RELATIVEPANELOPTIMIZATION

KSPROPERTY_CAMERACONTROL_EXTENDED_RELATIVEPANELOPTIMIZATION ist eine Eigenschafts-ID, die verwendet wird, um den Treiber zu informieren, ob die Kamera nach vorne gerichtet ist oder nicht, relativ zur aktiven Anzeige der Anwendung. Windows legt die Eigenschaft fest, wenn die neue WinRT-API-Eigenschaft PanelBasedOptimizationControl.Panel festgelegt wird.

Beispiele für das Festlegen von KSProperty-Steuerelementen finden Sie im AVStream-Kamerabeispieltreiber auf GitHub.

Tabelle "Nutzungszusammenfassung"

Herunterladen	Set	Ziel	Eigenschaftsdeskriptortyp	Eigenschaftswerttyp
Ja	Ja	Filter	KSPROPERTY	KSCAMERA_EXTENDEDPROP_HEADER

Bemerkungen

Die Eigenschaftsanforderung enthält eine KSCAMERA_EXTENDEDPROP_HEADER-Struktur und eine KSCAMERA_EXTENDEDPROP_VALUE-Struktur .

Die Gesamtgröße der Eigenschaftsdaten ist sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_VALUE).

Das Size-Element von KSCAMERA_EXTENDEDPROP_HEADER ist auf diese Gesamtdatengröße der Eigenschaft festgelegt.

Im Folgenden finden Sie Flags, die im KSCAMERA_EXTENDEDPROP_HEADER platziert werden können . Flags und KSCAMERA_EXTENDEDPROP_HEADER. Funktionsfelder .

Relativer Bereichsoptimierungsmodus	BESCHREIBUNG
KSCAMERA_EXTENDEDPROP_RELATIVEPANELOPTIMIZATION_OFF	Die Kamera verwendet den normalen Betriebsmodus
KSCAMERA_EXTENDEDPROP_RELATIVEPANELOPTIMIZATION_ON	Die Kamera verwendet die Optimierung relativ zu einer im Wertfeld beschriebenen Position.
KSCAMERA_EXTENDEDPROP_RELATIVEPANELOPTIMIZATION_DYNAMIC	Hinweis zur Kameraposition kann während des Streamings dynamisch angepasst werden, ohne den Stream zu durchbrechen

KSCAMERA_EXTENDEDPROP_RELATIVEPANELOPTIMIZATION ist immer ein synchrones Steuerelement.

Jede App kann die Eigenschaft lesen, aber nur Apps, die die Kamera für exklusiven Zugriff geöffnet haben, können in den Eigenschaftswert schreiben.

Ein geeigneter Fehlercode wird zurückgegeben, wenn versucht wird, die Eigenschaft ohne Zugriff im exklusiven Modus zu schreiben.

In Bezug auf die Zuordnung dieses DDI zum PanelBasedOptimizationControl legt die Anwendung, die PanelBasedOptimizationControl verwendet, den Panel-Wert fest, den Windows intern zum Programmieren des KSCAMERA_EXTENDEDPROP_VALUE Felds der Nutzlast verwendet.

Das Feld Funktion und Flags wird von Windows gesteuert.

Wenn der Treiber einen SET-Vorgang empfängt, während das Kameragerät gestreamt wird und das Flag KSCAMERA_EXTENDEDPROP_RELATIVEPANELOPTIMIZATION_DYNAMIC* nicht festgelegt ist, gibt der Treiber einen zustandsbasierten Fehler zurück.

Die folgende Tabelle enthält die Anforderungen für die KSCAMERA_EXTENDEDPROP_HEADER Strukturfelder bei Verwendung des Metadatensteuerelements.

Member	BESCHREIBUNG
Version	Dies muss 1 sein.
PinId	KSCAMERA_EXTENDEDPROP_FILTERSCOPE (0xFFFFFFFF)
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 durchgeführt wurde, muss dies 0 sein.
Funktion	Muss ein bisschen weise sein ODER der oben definierten unterstützten KSCAMERA_EXTENDEDPROP_RELATIVEPANELOPTIMIZATION_XXX Flags.
Flags	Dies ist ein Lese-/Schreibfeld. Dies kann entweder KSCAMERA_EXTENDEDPROP_RELATIVEPANELOPTIMIZATION_ON oder KSCAMERA_EXTENDEDPROP_RELATIVEPANELOPTIMIZATION_OFF oben definierten Flags sein.

Wenn KSCAMERA_EXTENDEDPROP_RELATIVEPANELOPTIMIZATION_ON im Feld Flags des KSCAMERA_EXTENDEDPROP_HEADER angegeben ist, muss das Feld Value.ul die PLD für die relative Richtung angeben, auf die sich die Kamera derzeit befindet.

Dies kann jeder der Enumerationswerte für ACPI PLD sein, ist aber am häufigsten Front, Back oder Unknown.

Wenn KSCAMERA_EXTENDEDPROP_RELATIVEPANELOPTIMIZATION_OFF angegeben ist, wird für SET-Vorgänge das Feld Wert ignoriert.

Bei GET-Vorgängen muss der Treiber die Richtung zurückgeben, für die die Kamera derzeit programmiert ist.

Wenn KSCAMERA_EXTENDEDPROP_RELATIVEPANELOPTIMIZATION_OFF angegeben ist oder kein Wert festgelegt wurde, muss die Standard-PLD des Geräts zurückgegeben werden.

Wenn KSCAMERA_EXTENDEDPROP_RELATIVEPANELOPTIMIZATION_ON angegeben wird, muss der zuletzt festgelegte Wert zurückgegeben werden.

Anforderungen

Header: ksmedia.h (include Ksmedia.h)