KSPROPERTY_CAMERACONTROL_REGION_OF_INTEREST_S Struktur (ksmedia.h)
Beschreibt die Eigenschaften von Interessanten Steuerelementen (ROI) im Eigenschaftensatz PROPSETID_VIDCAP_CAMERACONTROL_REGION_OF_INTEREST Kamerasteuerung. Der interessante Bereich 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;
Angehörige
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 Elemente der RECT- Struktur null sind, sollte das Gerät die Mitte des Bilds konzentrieren, und die verbleibenden Elemente dieser Struktur können ignoriert werden.
Die Koordinaten des Rechtecks beziehen sich auf die Videoauflösung der Vorschau.
AutoFocusLock
Wenn TRUE, sollte das Gerät den Fokus auf den aktuellen Wert sperren.
Dieses Element sollte ignoriert werden, wenn FocusRect- kein gültiger Wert ist.
AutoExposureLock
Wenn TRUE, sollte das Gerät die Belichtung des aktuellen Werts sperren.
Dieses Element sollte ignoriert werden, wenn FocusRect- kein gültiger Wert ist.
AutoWhitebalanceLock
Wenn TRUE-, sollte das Gerät die Einstellung für den Weißabgleich auf den aktuellen Wert sperren.
Dieses Element sollte ignoriert werden, wenn FocusRect- kein gültiger Wert ist.
Capabilities
Gibt an, ob das Gerät und der Treiber die Einstellung der region von Interesse automatisch oder manuell unterstützen. Dieses Element ist bitweise ODER dieser 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
Konfigurationskennzeichnungen für Kontrollvorgänge für die Region. Dies ist eine bitweise OR-Kombination der folgenden Werte.
Dieses Mitglied ist ab Windows 8.1 verfügbar.
| Wert | Bedeutung |
|---|---|
| KSPROPERTY_CAMERACONTROL_REGION_OF_INTEREST_CONFIG_FOCUS | Legen Sie den automatischen Fokus für den Bereich fest. |
| KSPROPERTY_CAMERACONTROL_REGION_OF_INTEREST_CONFIG_EXPOSURE | Legen Sie die automatische Belichtung für den Bereich 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 |
|---|---|
| mindestens unterstützte Client- | Windows 8 |
| mindestens unterstützte Server- | Windows Server 2012 |
| Header- | ksmedia.h (enthalten Ksmedia.h) |