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) |