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)