KSPROPERTY_CAMERACONTROL_S_EX-Struktur (ksmedia.h)
Gibt einen Kamerasteuerungsvorgang an, einschließlich der Einstellung des Blitzes, der Eigenschaften der Bildnadelsteuerung, des relevanten Bereichs im Bild oder der Videostabilisierung. Diese Struktur beschreibt filterbasierte Eigenschaften im PROPSETID_VIDCAP_CAMERACONTROL Eigenschaftensatz.
Unterstützt ab Windows 8.
Syntax
typedef struct {
KSPROPERTY Property;
LONG Value;
ULONG Flags;
ULONG Capabilities;
RECT FocusRect;
} KSPROPERTY_CAMERACONTROL_S_EX, *PKSPROPERTY_CAMERACONTROL_S_EX;
Member
Property
Gibt eine initialisierte KSPROPERTY-Struktur an, die den Eigenschaftensatz, die Eigenschafts-ID und den Anforderungstyp beschreibt.
Value
Gibt den Wert der Eigenschaft an. Dieser Member ist lese-/schreibzugriff.
Flags
Gibt für Get Requests die aktuelle Einstellung für die angegebene Eigenschaft aus den unten aufgeführten Werten an. Gibt für Set requests (Anforderungen festlegen) die gewünschte Einstellung für die angegebene Eigenschaft aus den unten aufgeführten Werten an. Dieser Member kann ein bitweises OR der folgenden Werte sein, die in Ksmedia.h definiert sind:
| Wert | BESCHREIBUNG |
|---|---|
| KSPROPERTY_CAMERACONTROL_FLAGS_AUTO | Gibt an, dass die Einstellung automatisch gesteuert wird. Wenn der Treiber diesen Wert empfängt, sollte er das Kamerasteuerelement synchron auf den Automatischen Modus setzen und dann zurückkehren. |
| KSPROPERTY_CAMERACONTROL_FLAGS_MANUAL | Gibt an, dass die Einstellung manuell gesteuert wird. Wenn der Treiber diesen Wert empfängt, sollte er das Kamerasteuerelement synchron auf den manuellen Modus festlegen und dann zurückgeben. |
| KSPROPERTY_CAMERACONTROL_FLAGS_ASYNCHRONOUS | Gibt an, ob der Treiber den Kamerasteuerungsvorgang asynchron ausführen soll, wobei die Anwendung einen Befehl für den Treiber ausgegeben hat, um die Kamerasteuerungseinstellungen vor der Aufnahme eines Bilds einzurichten. Dieses Flag darf 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 Steuerungsvorgang zu starten, und alle anderen Anforderungen für denselben Vorgang ablehnen, bis der erste Vorgang abgeschlossen ist. 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 des Capabilities-Elements 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.
Hinweise
Wenn ein angeforderter Kamerafokusvorgang abgeschlossen oder abgebrochen wird, sollte der Treiber ein Ereignis generieren, das durch den KSEVENT_CAMERACONTROL_FOCUS-Enumerationswert angegeben wird.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 8 |
| Unterstützte Mindestversion (Server) | Windows Server 2012 |
| Kopfzeile | ksmedia.h (include Ksmedia.h) |
Weitere Informationen
KSPROPERTY_CAMERACONTROL_FLASH_S
KSPROPERTY_CAMERACONTROL_REGION_OF_INTEREST_S