KSPROPERTY_CAMERACONTROL_EXTENDED_DIGITALWINDOW

Artikel
06/14/2023

KSPROPERTY_CAMERACONTROL_EXTENDED_DIGITALWINDOW ist eine Eigenschafts-ID, die das Anzeige- und Zoomfeld der Kamera angibt, während die Kamera streamingt.

Dieses Steuerelement ist ein potenzieller Ersatz für Schwenken, Neigen und Zoomen. Dieses Steuerelement gilt nur, während die Kamera aktiv gestreamt wird. Um aktiv zu streamen, bedeutet, dass sich ein Vorschau- oder Datensatzpin in KSSTATE_RUN befinden muss, bereit und in der Lage sein muss, Frames bereitzustellen.

Wenn ein Stream auf SET nicht aktiv ist, gibt dieses Steuerelement STATUS_INVALID_DEVICE_STATE zurück.

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

Tabelle "Nutzungszusammenfassung"

`Scope`	Control	type
Version 1	Filter	Synchron

Die folgenden Bitflags steuern die Eigenschafts-ID im Treiber:

#define KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_MANUAL             0x0000000000000000
#define KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_AUTOFACEFRAMING    0x0000000000000001

Beschreibung der Funktionen

Die folgenden Flags können im KSCAMERA_EXTENDEDPROP_HEADER platziert werden . Flags und KSCAMERA_EXTENDEDPROP_HEADER. Funktionsfelder .

Flag	Beschreibung
KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_MANUAL	Das digitale Fenster wird manuell von der Anwendung gesteuert.
KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_AUTOFACEFRAMING	Die Kamera passt das Digitalfenster automatisch an, um den Fokus auf das dominierende Gesicht in der Ansicht zu richten.

KSCAMERA_EXTENDEDPROP_DIGITALWINDOW ist immer ein synchrones Steuerelement.

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

Member	BESCHREIBUNG
Version	Muss 1 sein.
PinId	KSCAMERA_EXTENDEDPROP_FILTERSCOPE (0xFFFFFFFF)
Size	Muss sizeof(KSCAMERA_EXTENDEDPROP_HEADER)+ sizeof(KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_SETTING) sein
Ergebnis	Muss 0 enthalten. Dieses Feld wird nur verwendet, um das Ergebnis des letzten asynchronen SET-Vorgangs zurückzugeben.
Funktion	Muss KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_MANUAL unterstützen. Kann optional KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_AUTOFACEFRAMING unterstützen.
Flags	Muss KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_MANUAL oder KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_AUTOFACEFRAMING sein.

KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_SETTING

Diese Parameter sind schreibgeschützt, wenn KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_AUTOFACEFRAMING im Feld Flags festgelegt ist. Wenn KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_AUTOFACEFRAMING während eines SET-Vorgangs festgelegt wird, werden die folgenden Parameter ignoriert.

Parameter	BESCHREIBUNG
OriginX	Der Ursprung des digitalen Fensters entlang der X-Achse im Q24-Format. Muss standardmäßig 0 sein. OriginX darf nicht kleiner als VerandaLeft oder größer als VerandaRight – WindowSize sein.
OriginY	Der Ursprung des digitalen Fensters entlang der X-Achse im Q24-Format. Muss standardmäßig 0 sein. OriginX darf nicht kleiner als VerandaLeft oder größer als VerandaRight – WindowSize sein.
WindowSize	Die Größe des digitalen Fensters auf beiden Achsen im Q24-Format. Dies ist der Bruchteil der Vollansicht, die sowohl entlang der x- als auch der y-Achse sichtbar ist. WindowSize muss standardmäßig auf 0x01000000 (1.0 in Q24) festgelegt sein. WindowSize darf nicht kleiner als MinWindowSize oder größer als MaxWindowSize sein. Darüber hinaus darf WindowSize plus OriginX nicht größer als VerandaRight sein. WindowsSize plus OriginY ist möglicherweise nicht größer als VerandaBottom.
Reserviert	Auf 0 festlegen.