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)

Vedi anche

KSPROPERTY_CAMERACONTROL_FLASH_PROPERTY

RECT