KSPROPERTY_CAMERACONTROL_REGION_OF_INTEREST_S-Struktur (ksmedia.h)
Beschreibt die Eigenschaften von Steuerelementen für die Region von Interesse (ROI) im PROPSETID_VIDCAP_CAMERACONTROL_REGION_OF_INTEREST Kamerasteuerungseigenschaftensatz. Der bereich von Interesse ist ein Rechteck im Bild, das zum Fokussieren der Kamera verwendet wird. Diese Struktur gibt Eigenschaftswerte an, die in Anforderungen an den Kameratreiber verwendet werden.
Syntax
typedef struct {
RECT FocusRect;
BOOL AutoFocusLock;
BOOL AutoExposureLock;
BOOL AutoWhitebalanceLock;
union {
ULONG Capabilities;
ULONG Configuration;
};
} KSPROPERTY_CAMERACONTROL_REGION_OF_INTEREST_S, *PKSPROPERTY_CAMERACONTROL_REGION_OF_INTEREST_S;
Member
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-Apps verfügbar.
Wenn FocusRect kein gültiger Wert ist oder alle Member der RECT-Struktur null sind, sollte das Gerät die Mitte des Bilds fokussieren, und die restlichen Elemente dieser Struktur können ignoriert werden.
Die Koordinaten des Rechtecks beziehen sich auf die Videoauflösung in der Vorschau.
AutoFocusLock
Bei TRUE sollte das Gerät den Fokus auf den aktuellen Wert sperren.
Dieser Member sollte ignoriert werden, wenn FocusRect kein gültiger Wert ist.
AutoExposureLock
Wenn TRUE, sollte das Gerät die Exposition auf den aktuellen Wert sperren.
Dieser Member sollte ignoriert werden, wenn FocusRect kein gültiger Wert ist.
AutoWhitebalanceLock
Bei TRUE sollte das Gerät die Weißabgleichseinstellung auf den aktuellen Wert sperren.
Dieser Member sollte ignoriert werden, wenn FocusRect kein gültiger Wert ist.
Capabilities
Gibt an, ob das Gerät und der Treiber das Festlegen der relevanten Region automatisch oder manuell unterstützen. Dieses Element ist ein bitweiser OR der folgenden möglichen Werte:
| Wert | Bedeutung |
|---|---|
| KSPROPERTY_CAMERACONTROL_REGION_OF_INTEREST_FLAGS_AUTO | Das Gerät und der Treiber können die gewünschte Region automatisch festlegen. |
| KSPROPERTY_CAMERACONTROL_REGION_OF_INTEREST_FLAGS_MANUAL | Der Benutzer kann die gewünschte Region manuell festlegen. |
| KSPROPERTY_CAMERACONTROL_REGION_OF_INTEREST_FLAGS_ASYNC | ROI-Steuerungsfeatures werden asynchron ausgeführt. Diese Funktion ist ab Windows 8.1 verfügbar. |
Configuration
Konfigurationsflags für Steuerungsvorgänge für die Region. Dies ist eine bitweise OR-Kombination der folgenden Werte.
Dieses Element ist ab Windows 8.1 verfügbar.
| Wert | Bedeutung |
|---|---|
| KSPROPERTY_CAMERACONTROL_REGION_OF_INTEREST_CONFIG_FOCUS | Legen Sie den autofokus für die Region fest. |
| KSPROPERTY_CAMERACONTROL_REGION_OF_INTEREST_CONFIG_EXPOSURE | Legen Sie die automatische Belichtung für die Region fest. |
| KSPROPERTY_CAMERACONTROL_REGION_OF_INTEREST_CONFIG_WB | Legen Sie den automatischen Weißabgleich für die Region fest. |
| KSPROPERTY_CAMERACONTROL_REGION_OF_INTEREST_CONVERGEMODE | Aktivieren Sie die Konvergenz von Objekten in der Region. |
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 8 |
| Unterstützte Mindestversion (Server) | Windows Server 2012 |
| Kopfzeile | ksmedia.h (include Ksmedia.h) |