Partager via


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