KSPROPERTY_CAMERACONTROL_S_EX Struktur (ksmedia.h)

Artikel
02/07/2025

Gibt einen Kamerasteuerungsvorgang an, einschließlich des Festlegens des Blitzes, der Eigenschaften des Bild-Pin-Steuerelements, des für das Bild interessanten Bereichs oder der Videostabilisierung. Diese Struktur beschreibt filterbasierte Eigenschaften im PROPSETID_VIDCAP_CAMERACONTROL Eigenschaftensatz.

Wird ab Windows 8 unterstützt.

Syntax

typedef struct {
  KSPROPERTY Property;
  LONG       Value;
  ULONG      Flags;
  ULONG      Capabilities;
  RECT       FocusRect;
} KSPROPERTY_CAMERACONTROL_S_EX, *PKSPROPERTY_CAMERACONTROL_S_EX;

Angehörige

Property

Gibt eine initialisierte KSPROPERTY- Struktur an, die den Eigenschaftensatz, die Eigenschaften-ID und den Anforderungstyp beschreibt.

Value

Gibt den Wert der Eigenschaft an. Dieses Element ist Lese-/Schreibzugriff.

Flags

Gibt für Get-Anforderungen die aktuelle Einstellung für die angegebene Eigenschaft aus den unten aufgeführten Werten an. Gibt für Set-Anforderungen die gewünschte Einstellung für die angegebene Eigenschaft aus den unten aufgeführten Werten an. Dieses Element kann ein bitweiser ODER der folgenden Werte sein, die in Ksmedia.hdefiniert sind:

Wert	Beschreibung
KSPROPERTY_CAMERACONTROL_FLAGS_AUTO	Gibt an, dass die Einstellung automatisch gesteuert wird. Wenn der Treiber diesen Wert empfängt, sollte die Kamerasteuerung synchron auf den automatischen Modus festgelegt und dann zurückgegeben werden.
KSPROPERTY_CAMERACONTROL_FLAGS_MANUAL	Gibt an, dass die Einstellung manuell gesteuert wird. Wenn der Treiber diesen Wert empfängt, sollte die Kamerasteuerung synchron auf den manuellen Modus festgelegt und dann zurückgegeben werden.
KSPROPERTY_CAMERACONTROL_FLAGS_ASYNCHRONOUS	Gibt an, ob der Treiber den Kamerasteuerungsvorgang asynchron ausführen soll – wenn die Anwendung einen Befehl für den Treiber ausgegeben hat, um die Kamerasteuerungseinstellungen vor dem Aufnehmen eines Bilds einzurichten. Dieses Kennzeichen muss nur festgelegt werden, wenn entweder KSPROPERTY_CAMERACONTROL_FLAGS_MANUAL oder KSPROPERTY_CAMERACONTROL_FLAGS_AUTO festgelegt sind. Wenn dieser Flagwert und der KSPROPERTY_CAMERACONTROL_FLAGS_AUTO Flagwert festgelegt sind, sollte der Treiber einen Workerthread initiieren, um einen angeforderten Kontrollvorgang zu starten, und alle anderen Anforderungen für denselben Vorgang ablehnen, bis er das erste abgeschlossen hat. Nachdem der Vorgang erfolgreich abgeschlossen wurde, sollte der Treiber das KSEVENTSETID_CameraAsyncControl-Ereignis auslösen.

Capabilities

Wenn festgelegt, gibt an, dass der Treiber, wenn die Anwendung eine Abfrage sendet, den Wert der Capabilities Member der entsprechenden Kamerasteuerungsstruktur aus der folgenden Liste zurückgeben soll.

FocusRect

Eine RECT- Struktur, die den rechteckigen Bereich angibt, in dem das Gerät den Fokus festlegen soll. Diese Struktur ist nur für Windows-Desktopanwendungen verfügbar.

Bemerkungen

Wenn ein angeforderter Kamerafokusvorgang abgeschlossen oder abgebrochen wird, sollte der Treiber ein Ereignis generieren, das durch den wert der KSEVENT_CAMERACONTROL_FOCUS Enumeration angegeben ist.