Freigeben über

KSPROPERTY_CAMERACONTROL_EXTENDED_IRTORCHMODE

  • Artikel

Diese erweiterte Eigenschaftssteuerung wird vom Client verwendet, um den Leistungspegel und den Arbeitszyklus der Infrarotlampe einer IR-Kamera zu steuern. Es wird zusammen mit einer Standard-KSCAMERA_EXTENDEDPROP_HEADER-Struktur gefolgt von einer KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING-Struktur an den Treiber gesendet.

Nutzungszusammenfassungstabelle

Herunterladen Set Ziel Eigenschaftsdeskriptortyp Eigenschaftswerttyp
Yes Yes Filter KSPROPERTY KSCAMERA_EXTENDEDPROP_HEADER

Hinweise

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

Die Gesamtgröße der Eigenschaftsdaten ist sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING). 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 . Sie definieren die Betriebsmodi der IR-Taschenlampe.

Taschenlampenmodus BESCHREIBUNG
KSCAMERA_EXTENDEDPROP_IRTORCHMODE_OFF Aus
KSCAMERA_EXTENDEDPROP_IRTORCHMODE_ALWAYS_ON Immer aktiv
KSCAMERA_EXTENDEDPROP_IRTORCHMODE_ALTERNATING_FRAME_ILLUMINATION Ein für jeden anderen Frame

KSCAMERA_EXTENDEDPROP_IRTORCHMODE ist immer ein synchrones Steuerelement. Das Steuerelement hat kein definiertes Verhalten, wenn die Kamera nicht gestreamt wird.

Für eine GET-Anforderung legt ein Treiber die folgenden Felder fest:

  • KSCAMERA_EXTENDEDPROP_HEADER. Funktion mit einer Bitmaske der oben genannten KSCAMERA_EXTENDEDPROP_IRTORCHMODE_XXX-Flags , die die von der Kamera unterstützten Betriebsmodi darstellen.
  • KSCAMERA_EXTENDEDPROP_HEADER. Kennzeichnet eines der oben genannten KSCAMERA_EXTENDEDPROP_IRTORCHMODE_XXX-Flags , um den aktuellen Betriebsmodus anzugeben.
  • KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING. Modus auf 0.
  • KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING. Mindestens bis zum verfügbaren Mindestleistungslevel.
  • KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING. Max bis zum maximal verfügbaren Leistungsniveau.
  • KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING. Schritt bis zum Mindestschritt zwischen den Leistungsstufen.
  • KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING. VideoProc.ul auf die aktuelle Leistungsstufe. Dieser Wert sollte standardmäßig auf den gleichen Leistungsgrad festgelegt werden, der normalerweise vom Steuerelement für die Gesichtsauthentifizierung verwendet wird.

Für eine SET-Anforderung verwendet ein Treiber die folgenden Felder:

  • KSCAMERA_EXTENDEDPROP_HEADER. Flags zum Festlegen eines Betriebsmodus.
  • KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING. VideoProc.ul , um einen Leistungspegel festzulegen. Dieser Wert hat keine Auswirkungen auf KSCAMERA_EXTENDEDPROP_IRTORCHMODE_OFF.

Die folgende Tabelle enthält die Beschreibungen und 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_VIDEOPROCSETTING](/windows-hardware/drivers/ddi/ksmedia/ns-ksmedia-tagkscamera_extendedprop_videoprocsetting)) sein.

Ergebnis

Dieser Wert wird für synchrone Steuerelemente ignoriert.

Funktion

Kann eine beliebige Kombination aus KSCAMERA_EXTENDEDPROP_IRTORCHMODE_OFF, KSCAMERA_EXTENDEDPROP_IRTORCHMODE_ALWAYS_ON oder KSCAMERA_EXTENDEDPROP_IRTORCHMODE_ALTERNATIVE_FRAME_ILLUMINATION sein. Dieses Feld muss mindestens eine Funktion melden. Das Feld muss entweder KSCAMERA_EXTENDEDPROP_IRTORCHMODE_ALWAYS_ON oder KSCAMERA_EXTENDEDPROP_IRTORCHMODE_ALTERNATIVE_FRAME_ILLUMINATION oder beides melden. Der Wert KSCAMERA_EXTENDEDPROP_IRTORCHMODE_OFF ist optional.

Flags

Muss eines der Flags sein, die unter Funktion gemeldet werden. Der Standardwert muss entweder KSCAMERA_EXTENDEDPROP_IRTORCHMODE_ALWAYS_ON oder KSCAMERA_EXTENDEDPROP_IRTORCHMODE_ALTERNATIVE_FRAME_ILLUMINATION sein.

Die folgende Tabelle enthält die Beschreibungen und Anforderungen für die KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING Strukturfelder bei Verwendung des IR-Brennermodus-Steuerelements.

Member BESCHREIBUNG

Mode

Nicht verwendet. Muss den Wert 0 (null) haben.

Min/Max/Step

Min/Max/Step enthält das Minimum/Maximum/Inkrement der IR-Energieeinstellungen. Der Treiber muss diese für GET-Vorgänge zurückgeben. (Max – Min) muss gleichmäßig nach Schritt teilbar sein. Der Schritt darf nicht 0 (0) sein.

VideoProc

Bei SET-Vorgängen muss videoProc.Value.ul den Leistungspegel innerhalb des durch den Min/Max/Step-Parameter beschriebenen Bereichs angeben. Bei GET-Vorgängen muss der Treiber die aktuelle Leistungsstufe zurückgeben.

Reserviert

Nicht verwendet. Muss vom Treiber ignoriert werden.

Anforderungen

Header

 Ksmedia.h