structure KSPROPERTY_CAMERACONTROL_REGION_OF_INTEREST_S (ksmedia.h)
Décrit les propriétés de contrôle d’intérêt (ROI) dans le jeu de propriétés de contrôle de la caméra PROPSETID_VIDCAP_CAMERACONTROL_REGION_OF_INTEREST. La région d’intérêt est un rectangle dans l’image utilisée pour concentrer l’appareil photo. 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 sont relatives à la résolution vidéo en préversion.
AutoFocusLock
Si 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 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 TRUE, l’appareil doit verrouiller le paramètre d’équilibre blanc sur la valeur actuelle.
Ce membre doit être ignoré si FocusRect n’est pas une valeur valide.
Capabilities
Indique si le périphérique et le pilote prennent en charge la définition automatique ou manuelle de la région d’intérêt. Ce membre a une OU au niveau du bit de ces valeurs possibles :
| Valeur | Signification |
|---|---|
| KSPROPERTY_CAMERACONTROL_REGION_OF_INTEREST_FLAGS_AUTO | Le périphérique et le pilote peuvent définir automatiquement 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 l’équilibre automatique des blancs pour la région. |
| KSPROPERTY_CAMERACONTROL_REGION_OF_INTEREST_CONVERGEMODE | Activer la convergence des objets dans la région. |
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows 8 |
| serveur minimum pris en charge | Windows Server 2012 |
| d’en-tête | ksmedia.h (include Ksmedia.h) |