structure KSPROPERTY_CAMERACONTROL_S_EX (ksmedia.h)

Article
02/29/2024

Spécifie une opération de contrôle de caméra, y compris la définition du flash, des propriétés du contrôle d’épingle d’image, de la région d’intérêt dans l’image ou de la stabilisation vidéo. Cette structure décrit les propriétés basées sur les filtres dans le jeu de propriétés PROPSETID_VIDCAP_CAMERACONTROL .

Pris en charge à partir de Windows 8.

Syntaxe

typedef struct {
  KSPROPERTY Property;
  LONG       Value;
  ULONG      Flags;
  ULONG      Capabilities;
  RECT       FocusRect;
} KSPROPERTY_CAMERACONTROL_S_EX, *PKSPROPERTY_CAMERACONTROL_S_EX;

Membres

Property

Spécifie une structure KSPROPERTY initialisée qui décrit le jeu de propriétés, l’ID de propriété et le type de requête.

Value

Spécifie la valeur de la propriété. Ce membre est en lecture/écriture.

Flags

Indique, pour obtenir les demandes, le paramètre actuel de la propriété spécifiée à partir des valeurs répertoriées ci-dessous. Indique, pour définir les demandes, le paramètre souhaité pour la propriété spécifiée à partir des valeurs répertoriées ci-dessous. Ce membre peut être un OR au niveau du bit des valeurs suivantes définies dans Ksmedia.h :

Valeur	Description
KSPROPERTY_CAMERACONTROL_FLAGS_AUTO	Indique que le paramètre est contrôlé automatiquement. Si le pilote reçoit cette valeur, il doit définir le contrôle de caméra de manière synchrone en mode automatique, puis retourner.
KSPROPERTY_CAMERACONTROL_FLAGS_MANUAL	Indique que le paramètre est contrôlé manuellement. Si le pilote reçoit cette valeur, il doit définir le contrôle de caméra de manière synchrone en mode manuel, puis retourner.
KSPROPERTY_CAMERACONTROL_FLAGS_ASYNCHRONOUS	Indique si le pilote doit effectuer l’opération de contrôle de caméra de manière asynchrone, lorsque l’application a émis une commande pour que le pilote configure les paramètres de contrôle de la caméra avant de prendre une photo. Cet indicateur ne doit être défini que si KSPROPERTY_CAMERACONTROL_FLAGS_MANUAL ou KSPROPERTY_CAMERACONTROL_FLAGS_AUTO sont définis. Si cette valeur d’indicateur et la valeur d’indicateur KSPROPERTY_CAMERACONTROL_FLAGS_AUTO sont toutes deux définies, le pilote doit lancer un thread de travail pour démarrer une opération de contrôle demandée et doit rejeter toutes les autres demandes pour la même opération jusqu’à ce qu’elle ait terminé la première. Une fois l’opération terminée, le pilote doit déclencher l’événement KSEVENTSETID_CameraAsyncControl .

Capabilities

Si la valeur est définie, indique que lorsque l’application envoie une requête, le pilote doit retourner la valeur du membre Capabilities de la structure de contrôle de caméra appropriée à partir de la liste suivante.

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 de bureau Windows.

Remarques

Lorsqu’une opération de focus de caméra demandée est terminée ou annulée, le pilote doit générer un événement spécifié par la valeur d’énumération KSEVENT_CAMERACONTROL_FOCUS .