struttura KSPROPERTY_CAMERACONTROL_REGION_OF_INTEREST_S (ksmedia.h)
Descrive le proprietà del controllo dell'area di interesse (ROI) nel set di proprietà del controllo della fotocamera PROPSETID_VIDCAP_CAMERACONTROL_REGION_OF_INTEREST . L'area di interesse è un rettangolo nell'immagine usata per concentrarsi sulla fotocamera. Questa struttura specifica i valori delle proprietà utilizzati nelle richieste al driver della fotocamera.
Sintassi
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;
Members
FocusRect
Struttura RECT che specifica l'area rettangolare in cui il dispositivo deve impostare lo stato attivo. Questa struttura è disponibile solo per le app di Windows.
Se FocusRect non è un valore valido o se tutti i membri della struttura RECT sono zero, il dispositivo deve concentrarsi sul centro dell'immagine e i membri rimanenti di questa struttura possono essere ignorati.
Le coordinate del rettangolo sono relative alla risoluzione video di anteprima.
AutoFocusLock
Se TRUE, il dispositivo deve bloccare lo stato attivo sul valore corrente.
Questo membro deve essere ignorato se FocusRect non è un valore valido.
AutoExposureLock
Se TRUE, il dispositivo deve bloccare l'esposizione al valore corrente.
Questo membro deve essere ignorato se FocusRect non è un valore valido.
AutoWhitebalanceLock
Se TRUE, il dispositivo deve bloccare l'impostazione di bilanciamento del bianco sul valore corrente.
Questo membro deve essere ignorato se FocusRect non è un valore valido.
Capabilities
Indica se il dispositivo e il driver supportano l'impostazione automatica o manuale dell'area di interesse. Questo membro è un OR bit per bit di questi valori possibili:
| Valore | Significato |
|---|---|
| KSPROPERTY_CAMERACONTROL_REGION_OF_INTEREST_FLAGS_AUTO | Il dispositivo e il driver possono impostare automaticamente l'area di interesse. |
| KSPROPERTY_CAMERACONTROL_REGION_OF_INTEREST_FLAGS_MANUAL | L'utente può impostare manualmente l'area di interesse. |
| KSPROPERTY_CAMERACONTROL_REGION_OF_INTEREST_FLAGS_ASYNC | Le funzionalità di controllo ROI sono eseguite in modo asincrono. Questa funzionalità è disponibile a partire da Windows 8.1. |
Configuration
Flag di configurazione per le operazioni di controllo per l'area. Si tratta di una combinazione OR bit per bit dei valori seguenti.
Questo membro è disponibile a partire da Windows 8.1.
| Valore | Significato |
|---|---|
| KSPROPERTY_CAMERACONTROL_REGION_OF_INTEREST_CONFIG_FOCUS | Impostare lo stato attivo automatico per l'area. |
| KSPROPERTY_CAMERACONTROL_REGION_OF_INTEREST_CONFIG_EXPOSURE | Impostare l'esposizione automatica per l'area. |
| KSPROPERTY_CAMERACONTROL_REGION_OF_INTEREST_CONFIG_WB | Impostare il bilanciamento del bianco automatico per l'area. |
| KSPROPERTY_CAMERACONTROL_REGION_OF_INTEREST_CONVERGEMODE | Abilitare la convergenza degli oggetti nell'area. |
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 8 |
| Server minimo supportato | Windows Server 2012 |
| Intestazione | ksmedia.h (include Ksmedia.h) |