structure KSPROPERTY_CAMERACONTROL_REGION_OF_INTEREST_S (ksmedia.h)

Décrit les propriétés de contrôle de la région d’intérêt (ROI) dans le jeu de propriétés de contrôle de caméra PROPSETID_VIDCAP_CAMERACONTROL_REGION_OF_INTEREST . La zone d’intérêt est un rectangle dans l’image qui est utilisé pour mettre l’appareil photo au point. Cette structure spécifie les valeurs de propriété utilisées dans les requêtes adressées au pilote de caméra.

Syntaxe

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;

Membres

FocusRect

Structure RECT qui spécifie la région rectangulaire dans laquelle l’appareil doit définir le focus. Cette structure est disponible uniquement pour les applications Windows.

Si FocusRect n’est pas une valeur valide ou si tous les membres de la structure RECT sont zéro, l’appareil doit concentrer le centre de l’image et les membres restants de cette structure peuvent être ignorés.

Les coordonnées du rectangle concernent la résolution vidéo en préversion.

AutoFocusLock

Si la valeur est TRUE, l’appareil doit verrouiller le focus sur la valeur actuelle.

Ce membre doit être ignoré si FocusRect n’est pas une valeur valide.

AutoExposureLock

Si la valeur est TRUE, l’appareil doit verrouiller l’exposition à la valeur actuelle.

Ce membre doit être ignoré si FocusRect n’est pas une valeur valide.

AutoWhitebalanceLock

Si la valeur est TRUE, l’appareil doit verrouiller le paramètre de balance des blancs sur la valeur actuelle.

Ce membre doit être ignoré si FocusRect n’est pas une valeur valide.

Capabilities

Indique si l’appareil et le pilote prennent en charge la définition automatique ou manuelle de la région d’intérêt. Ce membre au niveau du bit OU de ces valeurs possibles :

Valeur	Signification
KSPROPERTY_CAMERACONTROL_REGION_OF_INTEREST_FLAGS_AUTO	L’appareil et le pilote peuvent automatiquement définir la région d’intérêt.
KSPROPERTY_CAMERACONTROL_REGION_OF_INTEREST_FLAGS_MANUAL	L’utilisateur peut définir manuellement la région d’intérêt.
KSPROPERTY_CAMERACONTROL_REGION_OF_INTEREST_FLAGS_ASYNC	Les fonctionnalités de contrôle roi s’exécutent de manière asynchrone. Cette fonctionnalité est disponible à partir de Windows 8.1.

Configuration

Indicateurs de configuration pour les opérations de contrôle pour la région. Il s’agit d’une combinaison OR au niveau du bit des valeurs suivantes.

Ce membre est disponible à partir de Windows 8.1.

Valeur	Signification
KSPROPERTY_CAMERACONTROL_REGION_OF_INTEREST_CONFIG_FOCUS	Définissez le focus automatique pour la région.
KSPROPERTY_CAMERACONTROL_REGION_OF_INTEREST_CONFIG_EXPOSURE	Définissez l’exposition automatique pour la région.
KSPROPERTY_CAMERACONTROL_REGION_OF_INTEREST_CONFIG_WB	Définissez la balance automatique des blancs pour la région.
KSPROPERTY_CAMERACONTROL_REGION_OF_INTEREST_CONVERGEMODE	Activez la convergence des objets dans la région.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 8
Serveur minimal pris en charge	Windows Server 2012
En-tête	ksmedia.h (inclure Ksmedia.h)

Voir aussi

KSPROPERTY_CAMERACONTROL_FLASH_PROPERTY

RECT