commande MCI_SETVIDEO

La commande MCI_SETVIDEO définit les valeurs associées à la lecture vidéo. Les appareils de vidéo numérique et de magnétoscope reconnaissent cette commande.

Pour envoyer cette commande, appelez la fonction mciSendCommand avec les paramètres suivants.

MCIERROR mciSendCommand(
  MCIDEVICEID wDeviceID, 
  MCI_SETVIDEO, 
  DWORD dwFlags, 
  (DWORD) (LPMCI_GENERIC_PARMS) lpSetVideo
);

Paramètres

wDeviceID

Identificateur d’appareil de l’appareil MCI qui doit recevoir le message de commande.

dwFlags

MCI_NOTIFY, MCI_WAIT ou MCI_TEST. Pour plus d’informations sur ces indicateurs, consultez Les indicateurs d’attente, de notification et de test.

lpSetVideo

Pointeur vers une structure MCI_GENERIC_PARMS . (Les appareils avec des jeux de commandes étendus peuvent remplacer cette structure par une structure spécifique à l’appareil.)

Valeur renvoyée

Retourne zéro en cas de réussite ou d’erreur dans le cas contraire.

Notes

Les indicateurs supplémentaires suivants sont utilisés avec le type d’appareil « digitalvideo » :

MCI_DGV_SETVIDEO_ALG

Le membre lpstrAlgorithm de la structure identifiée par lpSetVideo contient l’adresse d’une mémoire tampon contenant le nom d’un algorithme de compression vidéo. L’algorithme de compression est utilisé par les commandes MCI_RESERVE ou MCI_RECORD suivantes. Les algorithmes disponibles dépendent de l’appareil.

Si l’algorithme spécifié n’est pas compatible avec le format de fichier actuel, le format de fichier est remplacé par le format par défaut pour l’algorithme.

MCI_DGV_SETVIDEO_CLOCKTIME

Lorsqu’il est utilisé avec MCI_DGV_SETVIDEO_OVER, indique que l’heure est spécifiée en millisecondes et est une heure absolue. (Cette fois n’est pas en parallèle avec le jeu de l’espace de travail.)

MCI_DGV_SETVIDEO_INPUT

Modifie les MCI_DGV_SETVIDEO_BRIGHTNESS, MCI_DGV_SETVIDEO_COLOR, MCI_DGV_SETVIDEO_CONTRAST, MCI_DGV_SETVIDEO_GAMMA, MCI_DGV_SETVIDEO_SHARPNESS ou MCI_DGV_SETVIDEO_TINT afin qu’ils affectent le signal d’entrée et modifie ce qui est enregistré. Si possible, il s’agit de la valeur par défaut lors de la surveillance de l’entrée.

MCI_DGV_SETVIDEO_ITEM

Une constante vidéo est spécifiée dans le membre dwItem de la structure identifiée par lpSetVideo. La constante identifie la valeur en cours de définition. Vous pouvez spécifier les constantes suivantes avec cet indicateur :

MCI_AVI_SETVIDEO_DRAW_PROCEDURE

Une nouvelle adresse de procédure de dessin est spécifiée dans le membre dwValue de la structure identifiée par lpSetVideo. Vous pouvez spécifier une nouvelle procédure de dessin uniquement lorsque l’appareil est inactif. Cet indicateur est reconnu uniquement par le pilote vidéo numérique MCIAVI. Il n’existe aucun équivalent à cet indicateur dans l’interface de commande string.

MCI_AVI_SETVIDEO_PALETTE_COLOR

Une nouvelle couleur de palette est spécifiée dans les membres dwOver et dwValue de la structure identifiée par lpSetVideo. Le membre dwOver spécifie l’index de palette de la couleur à modifier et le membre dwValue spécifie la nouvelle couleur, sous forme de valeur RVB. Vous devez également spécifier les indicateurs MCI_DGV_SETVIDEO_OVER et MCI_DGV_SETVIDEO_VALUE avec MCI_DGV_SETVIDEO_ITEM lorsque vous utilisez cette constante. Cet indicateur est reconnu uniquement par le pilote vidéo numérique MCIAVI.

MCI_AVI_SETVIDEO_PALETTE_HALFTONE

Indique que la palette de demi-tons doit être utilisée au lieu de la palette par défaut. Cet indicateur est reconnu uniquement par le pilote vidéo numérique MCIAVI.

MCI_DGV_SETVIDEO_BITSPERPEL

Le nombre de bits par pixel est spécifié dans le membre dwValue de la structure identifiée par lpSetVideo. Le nombre de bits par pixel est utilisé pour enregistrer les données capturées ou enregistrées

MCI_DGV_SETVIDEO_BRIGHTNESS

Le niveau de luminosité vidéo est spécifié en tant que facteur dans le membre dwValue de la structure identifiée par lpSetVideo.

MCI_DGV_SETVIDEO_COLOR

Le niveau de saturation des couleurs vidéo est spécifié en tant que facteur dans le membre dwValue de la structure identifiée par lpSetVideo.

MCI_DGV_SETVIDEO_CONTRAST

Le niveau de contraste vidéo est spécifié en tant que facteur dans le membre dwValue de la structure identifiée par lpSetVideo.

MCI_DGV_SETVIDEO_FRAME_RATE

Une fréquence d’images est spécifiée dans le membre dwValue de la structure identifiée par lpSetVideo. Le taux est spécifié en unités d’images par seconde fois 1000. Par exemple, 29,97 images par seconde est spécifié comme 29970.

MCI_DGV_SETVIDEO_GAMMA

Une valeur d’exposant de correction gamma est spécifiée dans le membre dwValue de la structure identifiée par lpSetVideo. La correction gamma ajuste le mappage entre l’intensité encodée dans la source de présentation et la luminosité affichée. La valeur est l’exposant multiplié par 1000. Par exemple, 2200 indique un exposant de 2.2. La valeur 1000 indique un exposant de 1, ce qui n’applique aucune correction gamma.

MCI_DGV_SETVIDEO_KEY_COLOR

Une couleur de clé est spécifiée dans le membre dwValue de la structure identifiée par lpSetVideo. La couleur de clé est une valeur RVB.

MCI_DGV_SETVIDEO_KEY_INDEX

Une valeur d’index de clé est spécifiée dans le membre dwValue de la structure identifiée par lpSetVideo. Le paramètre d’index est un index de palette physique.

MCI_DGV_SETVIDEO_PALHANDLE

Un handle de palette est spécifié dans le membre dwValue de la structure identifiée par lpSetVideo. Le handle de palette est contenu dans le mot d’ordre inférieur. Les appareils de vidéo numérique ne doivent pas libérer la palette passée avec cette commande. Les applications doivent le libérer après la fermeture de l’appareil. Cet indicateur est pris en charge uniquement par les appareils qui utilisent des palettes. Si ce handle de palette spécifié est égal à zéro, la palette par défaut est utilisée.

MCI_DGV_SETVIDEO_SHARPNESS

Une valeur de netteté vidéo est spécifiée en tant que facteur dans le membre dwValue de la structure identifiée par lpSetVideo.

MCI_DGV_SETVIDEO_SOURCE

Une constante spécifiant la source de l’entrée vidéo est spécifiée dans le membre dwValue de la structure identifiée par lpSetVideo. Les constantes suivantes sont définies :

• MCI_DGV_SETVIDEO_SRC_NTSC : télévision NTSC.
• MCI_DGV_SETVIDEO_SRC_PAL : pal tv.
• MCI_DGV_SETVIDEO_SRC_RGB : vidéo RVB.
• MCI_DGV_SETVIDEO_SRC_SECAM : télévision SECAM.
• MCI_DGV_SETVIDEO_SRC_SVIDEO : S-Video.

MCI_DGV_SETVIDEO_STREAM

Un flux vidéo est spécifié dans le membre dwValue de la structure identifiée par lpSetVideo. La valeur entière spécifie le flux vidéo lu à partir de l’espace de travail. Si le flux n’est pas spécifié et que le format de fichier ne définit pas de flux par défaut, le premier flux vidéo physiquement entrelacé est lu.

MCI_DGV_SETVIDEO_TINT

Une valeur de teinte vidéo est spécifiée en tant que facteur dans le membre dwValue de la structure identifiée par lpSetVideo. En règle générale, cet ajustement est modélisé d’après le contrôle de teinte de nombreux téléviseurs couleur, 250 définis comme verts, 750 définis comme rouge et 0 (ou 1000) définis comme bleu. La valeur nominale est toujours 500.

MCI_DGV_SETVIDEO_OUTPUT

L’indicateur MCI_DGV_SETVIDEO_BRIGHTNESS, MCI_DGV_SETVIDEO_COLOR, MCI_DGV_SETVIDEO_CONTRAST, MCI_DGV_SETVIDEO_GAMMA, MCI_DGV_SETVIDEO_SHARPNESS ou MCI_DGV_SETVIDEO_TINT est modifié de sorte qu’il affecte uniquement le signal affiché et non ce qui est enregistré. Si possible, il s’agit de la valeur par défaut lors de la surveillance d’un fichier.

MCI_DGV_SETVIDEO_OVER

Un paramètre de longueur de transition est inclus dans le membre dwOver de la structure identifiée par lpSetVideo. La longueur de la transition spécifie le temps (dans le format d’heure actuel) nécessaire pour apporter une modification. Si cet indicateur n’est pas utilisé, la modification se produit immédiatement.

MCI_DGV_SETVIDEO_QUALITY

Le membre lpstrQuality de la structure identifiée par lpSetVideo contient l’adresse d’une mémoire tampon décrivant la qualité vidéo. Une chaîne de texte dans la mémoire tampon spécifie les caractéristiques de l’algorithme de compression vidéo.

L’indicateur MCI_DGV_SETVIDEO_ALG peut être utilisé pour sélectionner un descripteur de qualité pour l’algorithme spécifié. Si cet indicateur est omis, l’algorithme actuel est utilisé.

Les algorithmes et les noms de descripteurs disponibles dépendent de l’appareil. Chaque appareil fournit une documentation pour les algorithmes disponibles et une description des noms de descripteurs applicables. La commande MCI_QUALITY peut définir des noms de descripteurs supplémentaires. Tous les appareils prennent en charge les descripteurs « low », « medium » et « high ». La valeur par défaut est spécifique au pilote.

MCI_DGV_SETVIDEO_RECORD

Spécifie si l’enregistrement inclut ou exclut les données vidéo. Lorsqu’elles sont combinées avec MCI_SET_ON, les données vidéo sont enregistrées. Lorsqu’elles sont combinées avec MCI_SET_OFF, les données vidéo sont exclues. La valeur par défaut inclut les données vidéo.

MCI_DGV_SETVIDEO_SRC_NUMBER

Un numéro pour la source vidéo est spécifié dans le membre dwSourceNumber de la structure identifiée par lpSetVideo. S’il existe plusieurs entrées du type spécifié par MCI_DGV_SETVIDEO_VALUE, la valeur sélectionne l’entrée. Cet indicateur doit toujours être utilisé avec MCI_DGV_SETVIDEO_SOURCE. Si MCI_DGV_SETVIDEO_VALUE est omis, toutefois, le numéro de source spécifié indique la source absolue à utiliser comme spécifié dans la commande MCI_LIST .

MCI_DGV_SETVIDEO_STILL

Le nom de l’algorithme ou la valeur de qualité spécifié s’applique aux images fixes.

Chaque pilote de périphérique doit prendre en charge un algorithme « none », ce qui signifie qu’il n’y a pas de compression. Il s’agit de la valeur par défaut. Dans ce cas, les appareils de vidéo numérique enregistrent des images fixes en tant que bitmaps indépendantes des appareils RVB (DIB).

MCI_DGV_SETVIDEO_VALUE

Une valeur est incluse dans le membre dwValue de la structure identifiée par lpSetVideo. La signification de la valeur est spécifiée par l’indicateur MCI_DGV_SETVIDEO_ITEM .

MCI_SET_OFF

Désactive la sortie vidéo. Pour les appareils vidéo numériques, la désactivation de la vidéo définit les pixels dans le rectangle de destination défini par la commande MCI_PUT (ou sa valeur par défaut, la région cliente de la fenêtre active) sur une couleur unie, mais elle n’a aucun effet sur la mémoire tampon d’images. Vous pouvez masquer la fenêtre avec la commande MCI_WINDOW si vous le souhaitez. La source de la vidéo, qu’il s’agisse de l’espace de travail ou d’une entrée externe, peut continuer à stocker de nouvelles images dans la mémoire tampon d’images, mais elles ne sont pas affichées tant que la vidéo n’est pas activée. Bien que les applications doivent utiliser la commande MCI_SETVIDEO pour contrôler cette fonction, les appareils vidéo numériques doivent toujours prendre en charge cet indicateur. Valeur par défaut après l’ouverture.

MCI_SET_ON

Active la sortie vidéo.

Pour les appareils vidéo numériques, le paramètre lpSetVideo pointe vers une structure MCI_DGV_SETVIDEO_PARMS .

Les indicateurs supplémentaires suivants sont utilisés avec le type d’appareil « vcr » :

MCI_VCR_SETVIDEO_RECORD

Définit l’enregistrement vidéo sur activé ou désactivé. Utilisé conjointement avec l’un des indicateurs suivants :

• MCI_SET_ON. Enregistrement vidéo activé.
• MCI_SET_OFF. Enregistrement vidéo désactivé. Il peut être nécessaire de désactiver d’abord l’enregistrement d’assemblage (à l’aide de la commande MCI_SET avec l’indicateur MCI_VCR_SET_ASSEMBLE_RECORD désactivé) avant de désactiver l’enregistrement vidéo.

MCI_TRACK

Le membre dwTrack de la structure identifiée par lpSetVideo spécifie la piste affectée par la commande .

MCI_VCR_SETVIDEO_SOURCE

Définit la source vidéo et doit être utilisé avec l’indicateur MCI_VCR_SETVIDEO_TO .

MCI_VCR_SETVIDEO_MONITOR

Définit le moniteur de source vidéo et doit être utilisé avec l’indicateur MCI_VCR_SETVIDEO_TO.

MCI_VCR_SETVIDEO_TO

Le membre dwTo de la structure identifiée par lpSetVideo contient l’une des constantes suivantes :

**MCI\_VCR\_SRC\_TYPE\_TUNER**

**MCI\_VCR\_SRC\_TYPE\_LINE**

**MCI\_VCR\_SRC\_TYPE\_AUX**

**MCI\_VCR\_SRC\_TYPE\_GENERIC**

**MCI\_VCR\_SRC\_TYPE\_MUTE**

**MCI\_VCR\_SRC\_TYPE\_OUTPUT**

**MCI\_VCR\_SRC\_TYPE\_RGB**

**MCI\_VCR\_SETVIDEO\_NUMBER**

Le membre dwNumber de la structure identifiée par lpSetVideo contient l’entrée vidéo (du type spécifié dans le membre dwTo ) à utiliser.

Pour les appareils VCR, le paramètre lpSetVideo pointe vers une structure MCI_VCR_SETVIDEO_PARMS .

Spécifications

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
En-tête	Mmsystem.h (inclure Windows.h)

Voir aussi

MCI

Commandes MCI