_Commande MCI SETVIDEO

La _ commande MCI SETVIDEO définit les valeurs associées à la lecture vidéo. Les appareils vidéo numériques et VCR 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 de l’appareil MCI qui doit recevoir le message de commande.

dwFlags

MCI _ NOTIFY, l' _ attente MCI ou le _ test MCI. Pour plus d’informations sur ces indicateurs, consultez les indicateurs d’attente, de notification et de test.

lpSetVideo

Pointeur vers une structure de _ _ PARMS générique MCI . (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 une erreur.

Remarques

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 de _ réserve MCI ou d' _ enregistrement MCI suivantes. Les algorithmes disponibles dépendent du périphérique.

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

MCI _ DGV _ SETVIDEO _ CLOCKTIME

Lorsqu’il est utilisé avec MCI _ DGV _ SETVIDEO _ sur, indique que l’heure est spécifiée en millisecondes et est l’heure absolue. (Cette heure n’est pas à l’étape de la diffusion de l’espace de travail.)

_entrée MCI DGV _ SETVIDEO _

Modifie la _ _ _ teinte MCI _ DGV _ SETVIDEO _ Brightness, MCI _ DGV _ SETVIDEO _ Color, MCI _ DGV _ SETVIDEO _ Contrast, MCI _ DGV _ SETVIDEO _ gamma, MCI _ DGV _ SETVIDEO _ net ou MCI DGV SETVIDEO, afin qu’elle affecte le signal d’entrée et modifie ce qui est enregistré. Si possible, il s’agit de la valeur par défaut lors de l’analyse de l’entrée.

_ _ élément SETVIDEO DGV _ MCI

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

_procédure de dessin MCI AVI _ SETVIDEO _ _

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 de MCIAVI. Il n’existe aucun équivalent à cet indicateur dans l’interface de commande de chaîne.

_couleur de _ la _ palette SETVIDEO AVI _ MCI

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 la forme d’une valeur RVB. Vous devez également spécifier les indicateurs de _ _ _ valeur MCI _ DGV _ SETVIDEO _ sur et MCI DGV avec l' _ _ _ élément MCI DGV SETVIDEO lorsque vous utilisez cette constante. Cet indicateur est reconnu uniquement par le pilote vidéo de MCIAVI.

_demi- _ _ _ teinte de la palette SETVIDEO AVI MCI

Indique que la palette de demi-teintes doit être utilisée au lieu de la palette par défaut. Cet indicateur est reconnu uniquement par le pilote vidéo de 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

_luminosité de _ SETVIDEO _ DGV MCI

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

_couleur MCI DGV _ SETVIDEO _

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

_ _ contraste SETVIDEO DGV _ MCI

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

_fréquence d’images MCI DGV _ SETVIDEO _ _

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 (1000). Par exemple, 29,97 images par seconde sont spécifiées sous la forme 29970.

_DGV MCI _ 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. Une valeur de 1000 indique un exposant de 1, qui n’applique aucune correction gamma.

_couleur de _ _ clé SETVIDEO DGV MCI _

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

_index de _ _ clé SETVIDEO DGV MCI _

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 descripteur de palette est spécifié dans le membre dwValue de la structure identifiée par lpSetVideo. Le descripteur de palette est contenu dans le mot de poids faible. Les périphériques vidéo numériques ne doivent pas libérer la palette transmise avec cette commande. Les applications doivent le libérer après avoir fermé l’appareil. Cet indicateur est pris en charge uniquement par les appareils qui utilisent des palettes. Si le handle de palette spécifié est égal à zéro, la palette par défaut est utilisée.

_ _ netteté MCI DGV SETVIDEO _

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.

_source MCI DGV _ SETVIDEO _

Une constante qui spécifie 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 Television.
  • MCI _ DGV _ SETVIDEO _ src _ RGB : vidéo RVB.
  • MCI _ DGV _ SETVIDEO _ src _ SECAM : SECAM Television.
  • MCI _ DGV _ SETVIDEO _ src _ SVIDEO : S-Video.

_flux MCI DGV _ SETVIDEO _

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 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 entrelacé physiquement est lu.

_ _ teinte MCI DGV SETVIDEO _

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é après le contrôle de la teinte de nombreux jeux de télévision couleur, avec 250 défini en vert, 750 défini en rouge et 0 (ou 1000) défini en bleu. La valeur nominale est toujours 500.

_sortie MCI DGV _ SETVIDEO _

La couleur _ MCI _ DGV SETVIDEO _ Brightness, MCI _ DGV _ SETVIDEO _ Color, MCI _ DGV _ SETVIDEO _ Contrast, MCI _ DGV _ SETVIDEO _ gamma, MCI _ DGV _ SETVIDEO _ net ou MCI _ DGV _ SETVIDEO _ est modifiée de sorte qu’elle affecte uniquement le signal affiché et non ce qui est enregistré. Si possible, il s’agit de la valeur par défaut lors de l’analyse d’un fichier.

MCI _ DGV _ SETVIDEO _

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

_DGV MCI _ SETVIDEO _

Le membre lpstrQuality de la structure identifiée par lpSetVideo contient l’adresse d’une mémoire tampon décrivant la qualité de la 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 du périphérique. Chaque appareil fournit de la documentation pour les algorithmes disponibles et une description des noms de descripteur 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.

_enregistrement MCI DGV _ SETVIDEO _

Spécifie si l’enregistrement inclut ou exclut les données vidéo. Lorsqu’elles sont combinées avec MCI _ _ activé, les données vidéo sont enregistrées. Lorsqu’elle est associée à l' _ _ option MCI désactivée, les données vidéo sont exclues. La valeur par défaut comprend les données vidéo.

_ _ numéro SRC du SETVIDEO DGV _ MCI _

Un nombre 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 la _ _ _ valeur SETVIDEO de MCI DGV, la valeur sélectionne l’entrée. Cet indicateur doit toujours être utilisé avec la _ _ _ source MCI DGV SETVIDEO. Toutefois, si la _ _ _ valeur de SETVIDEO DGV MCI est omise, le numéro de source spécifié indique la source absolue à utiliser comme indiqué dans la commande de _ liste MCI .

MCI _ DGV _ SETVIDEO _ toujours

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

Chaque pilote de périphérique doit prendre en charge l’algorithme « None », ce qui signifie qu’aucune compression n’est nécessaire. Il s’agit de la valeur par défaut. Dans ce cas, les périphériques vidéo numériques enregistrent des images fixes sous forme de bitmaps indépendantes des appareils RVB (DIB).

_ _ valeur SETVIDEO de DGV MCI _

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 _ _ désactivé

Désactive la sortie vidéo. Pour les périphériques vidéo numériques, la désactivation de la vidéo définit les pixels du rectangle de destination défini par la commande _ put de MCI (ou la région cliente de la fenêtre active) sur une couleur unie, mais elle n’a aucun effet sur la mémoire tampon de trame. Si vous le souhaitez, vous pouvez masquer la fenêtre avec la commande de _ fenêtre MCI . La source de 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 de trame, mais elles ne sont pas affichées tant que la vidéo n’est pas activée. Alors 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. La valeur par défaut après une ouverture est activée.

MCI _ activé _

Active la sortie vidéo.

Pour les périphériques 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 » :

_ _ enregistrement SETVIDEO magnétoscope _ MCI

Définit l’enregistrement vidéo sur on ou OFF. Utilisé conjointement avec l’un des indicateurs suivants :

  • MCI _ DÉFINI _ sur. Enregistrement vidéo activé.
  • MCI _ _désactivée. Enregistrement vidéo désactivé. Il peut être nécessaire de désactiver d’abord l’enregistrement de l’assembly (à l’aide de la commande _ Set MCI avec l’indicateur de l' _ _ _ _ enregistrement assembler de l’ensemble magnétoscope MCI défini sur OFF) avant que l’enregistrement vidéo puisse être désactivé.

_piste MCI

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

_ _ source SETVIDEO magnétoscope _ MCI

Définit la source vidéo et doit être utilisé avec le magnétoscope MCI _ _ SETVIDEO _ pour signaler.

_ _ moniteur SETVIDEO magnétoscope _ MCI

Définit le moniteur de source vidéo et doit être utilisé avec le _ magnétoscope MCI _ SETVIDEO _ pour signaler.

_magnétoscope MCI _ SETVIDEO _ à

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

**\_tuner de \_ \_ type SRC magnétoscope MCI \_**
**\_ligne de \_ \_ type SRC magnétoscope MCI \_**
**\_magnétoscope MCI \_ type de source \_ \_ aux**
**\_type de source de magnétoscope MCI \_ \_ \_ générique**
**\_type de source de magnétoscope MCI \_ \_ \_ muet**
**\_sortie de \_ \_ type SRC magnétoscope MCI \_**
**\_type de source de magnétoscope MCI \_ \_ \_ RGB**
**\_ \_ numéro SETVIDEO magnétoscope \_ MCI**

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 périphériques 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