set, commande

Notes

Communication sans préjugé Microsoft prend en charge un environnement diversifié et inclusif. Dans ce document, il y a des références au mot « esclave ». Le Guide de style de Microsoft pour les communications Bias-Free reconnaît cela comme un mot d’exclusion. Ce libellé est utilisé, car il s’agit actuellement de la formulation utilisée dans les commandes. Par souci de cohérence, ce document contient ce mot. Lorsque ce mot est modifié dans les commandes, nous corrigeons l’alignement de ce document.

La commande set établit les paramètres de contrôle pour l’appareil. Les périphériques audio CD, digital-video, SÉQUENCE MIDI, VCR, videodisc, video-overlay et waveform-audio reconnaissent cette commande.

Pour envoyer cette commande, appelez la fonction mciSendString avec le paramètre lpszCommand défini comme suit.

_stprintf_s(
  lpszCommand,
  TEXT("set %s %s %s"),
  lpszDeviceID,
  lpszSetting,
  lpszFlags
);
      

Paramètres

lpszDeviceID

Identificateur d’un appareil MCI. Cet identificateur ou alias est affecté à l’ouverture de l’appareil.

lpszSetting

Indicateur pour l’établissement des paramètres de contrôle. Le tableau suivant répertorie les types d’appareils qui reconnaissent la commande set et les indicateurs utilisés par chaque type.

Type d’appareil	Indicateurs de commande
cdaudio	l’audio est désactivé audio tout activé audio désactivé audio gauche activé audio directement désactivé audio directement activé porte fermée porte ouverte millisecondes de format de temps heure format msf format d’heure tmsf
digitalvideo	l’audio est désactivé audio tout activé audio désactivé audio gauche activé audio directement désactivé audio directement activé porte fermée porte ouverte format de fichier rechercher exactement sur rechercher exactement désactivé facteur de vitesse format de fichier still intervalles de format de temps millisecondes de format de temps vidéo désactivée vidéo sur
superposition	l’audio est désactivé audio tout activé audio désactivé audio gauche activé audio directement désactivé audio directement activé porte fermée porte ouverte vidéo désactivée vidéo sur
sequencer	l’audio est désactivé audio tout activé audio désactivé audio gauche activé audio directement désactivé audio directement activé porte fermée porte ouverte master MIDI master aucun master SMPTE heure de décalage mappeur de port port none port port_number fichier esclave esclave MIDI slave none SMPTE esclave tempo tempo_value millisecondes de format de temps format d’heure SMPTE fps drop de format d’heure SMPTE 30 pointeur de chanson au format heure
Magnétoscope	assembler l’enregistrement sur assembly record off l’audio est désactivé audio tout activé audio désactivé audio gauche activé audio directement désactivé audio directement activé heure de l’horloge format compteur valeur de compteur porte fermée porte ouverte compteur d’index date d’index heure d’index heure d’index durée du codelength délai d’attente durée du postroll - duration Sous tension mise hors tension durée du pré-inscription fournisseur de services au format d’enregistrement format d’enregistrement LP format d’enregistrement EP facteur de vitesse cadres de format de temps heure format hms format d’heure millisecondes format d’heure msf temps format SMPTE fps drop de format d’heure SMPTE 30 format d’heure tmsf compteur de mode de temps détection du mode de temps time mode timecode suivi plus suivi moins Réinitialisation du suivi
vidéodisc	audio désactivé audio tout sur audio désactivé audio laissé sur audio désactivé à droite audio à droite sur porte fermée porte ouverte cadres de format de temps heure format hms format d’heure millisecondes suivi du format de temps vidéo désactivée vidéo sur
waveaudio	entier d’alignement n’importe quelle entrée n’importe quelle sortie audio désactivé audio tout sur audio désactivé audio laissé sur audio désactivé à droite audio à droite sur bitspersample bit_count octetspersec byte_rate canaux channel_count porte fermée porte ouverte balise de format pcm balise de format entier d’entrée entier de sortie samplespersec entier octets de format de temps format d’heure millisecondes exemples de format de temps

Le tableau suivant répertorie les indicateurs qui peuvent être spécifiés dans le paramètre lpszSetting et leurs significations.

Valeur	Signification
entier d’alignement	Définit l’alignement des blocs de données par rapport au début des données transmises à l’appareil audio de forme d’onde. Le fichier est enregistré dans ce format.
n’importe quelle entrée	Utilisez toute entrée prenant en charge le format actuel lors de l’enregistrement. Il s'agit du paramètre par défaut.
n’importe quelle sortie	Utilisez n’importe quelle sortie qui prend en charge le format actuel lors de la lecture. Il s’agit de la valeur par défaut.
assembler l’enregistrement le assembler l’enregistrement désactivé	En mode assemblage, toutes les pistes sont enregistrées comme défini par l’appareil. La plupart des magnétoscopes sont en mode assemblage par défaut.
audio désactivé audio tout sur	Désactive ou active la sortie audio. Les appareils de superposition vidéo, le séquenceur MCISEQ et le périphérique audio de forme d’onde MCIWAVE ne prennent pas en charge cet indicateur.
audio désactivé audio laissé sur audio désactivé à droite audio à droite sur	Désactive ou active la sortie sur le canal audio de gauche ou de droite. Les appareils de superposition vidéo, le séquenceur MCISEQ et le périphérique audio de forme d’onde MCIWAVE ne prennent pas en charge cet indicateur.
bitspersample bit_count	Définit le nombre de bits par exemple PCM (Pulse Code Modulation) lu ou enregistré. Le fichier est enregistré dans ce format.
octetspersec byte_rate	Définit le nombre moyen d’octets par seconde lus ou enregistrés. Le fichier est enregistré dans ce format.
canaux channel_count	Définit les canaux de lecture et d’enregistrement. Le fichier est enregistré dans ce format.
heure de l’horloge	Définit l’heure de l’horloge externe sur l’heure. Le format est spécifié sous la forme d’un entier long non signé.
format de compteur	Définissez le format d’heure du compteur, tel que retourné par status « compteur ». Pour plus d’informations sur les types applicables, consultez la commande set « time format ».
valeur de compteur	Définit le compteur VCR sur la valeur spécifiée. La valeur doit être spécifiée dans le format de compteur actuel. Pour plus d’informations, consultez la commande set « counter format ».
porte fermée	Retire le plateau et ferme la porte, si possible. Pour les magnétoscopes, charge automatiquement la bande.
porte ouverte	Ouvre la porte et éjecte le plateau ou le ruban, si possible.
format de fichier	Spécifie un format de fichier utilisé pour les commandes d’enregistrement ou de capture . S’il est omis, il peut s’agit par défaut d’un format défini par le pilote de périphérique. Si le format de fichier spécifié est en conflit avec l’algorithme et la qualité actuellement sélectionnés, ils sont modifiés par défaut pour le format de fichier. Les formats de fichier suivants sont définis : avi : spécifie le format AVI. avss : spécifie le format AVSS. dib : spécifie le format DIB. jfif : spécifie le format JFIF. jpeg : spécifie le format JPEG. mpeg : spécifie le format MPEG. rdib : spécifie le format DIB RLE. rjpeg : spécifie le format RJPEG.
format tag pcm	Définit le type de format sur PCM pour la lecture et l’enregistrement. Le fichier est enregistré dans ce format.
balise de format	Définit le type de format pour la lecture et l’enregistrement. Le fichier est enregistré dans ce format.
index timecode compteur d’index date d’index heure de l’index	Définit l’écran d’affichage actuel sur le magnétoscope.
entier d’entrée	Définit le canal audio utilisé comme entrée.
durée de la longueur	Définit la longueur spécifiée par l’utilisateur de la bande dans le magnétoscope. Cette longueur est retournée par la commande status « length » et est fournie pour la compatibilité avec les applications qui nécessitent que cette commande retourne une longueur valide.
master midi	Définit le séquenceur MIDI comme source de synchronisation. Les données de synchronisation sont envoyées au format MIDI. Le séquenceur MCISEQ ne prend pas en charge cet indicateur.
master aucun	Empêche le séquenceur MIDI d’envoyer des données de synchronisation. Le séquenceur MCISEQ ne prend pas en charge cet indicateur.
master smpte	Définit le séquenceur MIDI comme source de synchronisation. Les données de synchronisation sont envoyées au format SMPTE (Society of Motion Picture and Television Engineers). Le séquenceur MCISEQ ne prend pas en charge cet indicateur.
heure de décalage	Définit l’heure de décalage SMPTE. Le décalage est l’heure de début d’une séquence basée sur SMPTE. L’heure est exprimée sous la forme hh: mm: ss: ff, où hh est heures, mm est minutes, ss est secondes et ff est images.
entier de sortie	Définit le canal audio utilisé comme sortie.
délai d’attente	Définit la durée maximale, en millisecondes, d’une commande de pause . Une valeur de délai d’expiration de zéro indique qu’aucun délai d’attente ne se produira.
durée du postroll	Définit la longueur, au format d’heure actuel, nécessaire pour freiner le transport du magnétoscope lors de l’émission d’une commande d’arrêt ou de pause .
mappeur de port	Définit le mappeur MIDI comme port recevant les messages MIDI. Cette commande échoue si le mappeur MIDI ou un port dont il a besoin est utilisé par une autre application.
port none	Désactive l’envoi de messages MIDI. Cette commande ferme également un port MIDI.
port port_number	Définit le port MIDI qui reçoit les messages MIDI. Cette commande échoue si le port que vous essayez d’ouvrir est utilisé par une autre application.
Sous tension mise hors tension	Met l’appareil sous tension ou hors tension.
durée de pré-inscription	Définit la longueur, dans le format d’heure actuel, nécessaire pour stabiliser la sortie vcr.
format d’enregistrement SP format d’enregistrement LP format d’enregistrement EP	Définit le mode d’enregistrement pour le magnétoscope sur SP pour la lecture standard, EP pour la lecture étendue ou LP pour la lecture longue. Ces valeurs ne sont pas destinées à être spécifiques à VHS. Ils sont mappés à trois modes appropriés avec d’autres formats de bande. Par exemple, le fournisseur de services correspond à l’enregistrement le plus rapide et de la plus haute qualité.
samplespersec entier	Définit le taux d’échantillonnage pour la lecture et l’enregistrement. Le fichier est enregistré dans ce format.
rechercher exactement sur rechercher exactement désactivé	Sélectionne l’un des deux modes de recherche. Avec « rechercher exactement activé », la recherche se déplace toujours vers le cadre spécifié. Avec « rechercher exactement désactivé », la recherche se déplace vers l’image clé la plus proche avant l’image spécifiée.
fichier esclave	Définit le séquenceur MIDI pour utiliser les données de fichier comme source de synchronisation. Il s'agit du paramètre par défaut.
esclave midi	Définit le séquenceur MIDI pour qu’il utilise les données MIDI entrantes pour la source de synchronisation. Le séquenceur reconnaît les données de synchronisation au format MIDI. Le séquenceur MCISEQ ne prend pas en charge cet indicateur.
esclave aucun	Définit le séquenceur MIDI pour ignorer la synchronisation
esclave smpte	Définit le séquenceur MIDI pour qu’il utilise les données MIDI entrantes pour la source de synchronisation. Le séquenceur reconnaît les données de synchronisation au format SMPTE. Le séquenceur MCISEQ ne prend pas en charge cet indicateur.
facteur de vitesse	Définit la vitesse relative de la lecture vidéo et audio à partir de l’espace de travail. Le facteur est le rapport entre la fréquence d’images nominale et la fréquence d’images souhaitée, où la fréquence d’images nominale est de 1 000. (Un taux de 500 est la moitié de la vitesse normale, 2000 est deux fois la vitesse normale, et ainsi de suite.) La définition de la vitesse sur zéro lit la vidéo aussi rapidement que possible sans supprimer les images et sans audio.
Format de fichier still	Spécifie le format de fichier utilisé pour les commandes de capture.
tempo tempo_value	Définit le tempo de la séquence en fonction du format d’heure actuel. Pour un fichier basé sur PPQN, le tempo_value est interprété comme des battements par minute. Pour un fichier SMPTE, le tempo_value est interprété comme des images par seconde.
octets de format de temps	Dans un format de fichier PCM, définit le format d’heure sur octets. Toutes les informations de position sont spécifiées sous forme d’octets à la suite de cette commande.
cadres de format de temps	Définit le format d’heure sur les images. Toutes les commandes qui utilisent des valeurs de position supposent des trames. Lorsque l’appareil est ouvert, frames est le mode par défaut. Pris en charge par les vidéodiscs au format CAV.
heure format hms	Définit le format d’heure sur heures, minutes et secondes. Toutes les commandes qui utilisent des valeurs de position supposent HMS. HMS est le format par défaut pour les vidéodiscS CLV. Spécifiez une valeur HMS sous la forme hh:mm:ss, où hh est heures, mm en minutes et ss en secondes. Vous pouvez omettre un champ si celui-ci et tous les champs suivants sont zéro. Par exemple, 3, 3:0 et 3:0:0 sont tous des moyens valides d’exprimer 3 heures.
format d’heure millisecondes	Définit le format d’heure sur millisecondes. Toutes les commandes qui utilisent des valeurs de position supposent des millisecondes. Vous pouvez abréger les millisecondes en « ms ». Pour les appareils sequencer, le fichier de séquence définit le format par défaut sur PPQN ou SMPTE. Les appareils de superposition vidéo ne prennent pas en charge cet indicateur.
format d’heure msf	Définit le format d’heure sur minutes, secondes et images. Toutes les commandes qui utilisent des valeurs de position supposent MSF (format par défaut pour l’audio CD). Spécifiez une valeur MSF comme mm:ss:ff, où mm est en minutes, ss en secondes et ff en images. Vous pouvez omettre un champ si celui-ci et tous les champs suivants sont zéro. Par exemple, 3, 3:0 et 3:0:0 sont des façons valides d’exprimer 3 minutes. Les champs MSF ont les valeurs maximales suivantes : Minutes 99 Secondes 59 Images 74
exemples de format de temps	Définit le format d’heure sur des exemples. Toutes les informations de position sont spécifiées sous forme d’exemples suivant cette commande.
format d’heure smpte 24 format d’heure smpte 25 format d’heure smpte 30	Définit le format d’heure sur une fréquence d’images SMPTE. Pour les magnétoscopes, définit le format d’heure sur hh:mm:ss:ff, où les valeurs légales sont de 00:00:00:00 à 23:59:59:xx, et xx est inférieur aux images par seconde, comme spécifié par le nombre 24, 25 ou 30 spécifié dans l’indicateur. En entrée, deux-points (:) sont nécessaires pour séparer les composants. Les unités les moins significatives peuvent être omises si elles sont égales à 00 ; par exemple, 02:00 est identique à 02:00:00:00. Toutes les commandes qui utilisent des valeurs de position prennent le format SMPTE. Le fichier de séquence définit le format par défaut sur PPQN ou SMPTE.
time format smpte 30 drop	Définit le format d’heure sur la fréquence d’images de suppression SMPTE 30. Pour les magnétoscopes, identiques à SMPTE 30, sauf que certaines positions de timecode sont supprimées du format pour que les positions de timecode enregistrées pour chaque image (à la fréquence d’images NTSC de 29,97 i/s) correspondent au temps réel (à 30 i/s). Les positions de timecode qui sont supprimées sont les suivantes : deux toutes les minutes, sur la minute, pour les neuf premières de toutes les dix minutes de contenu enregistré. Par exemple, à 01:04:59:29, la position de code horaire suivante est 01:05:00:02, et non 01:05:00:00. Toutes les commandes qui utilisent des valeurs de position prennent le format SMPTE. Le fichier de séquence définit le format par défaut sur PPQN ou SMPTE.
pointeur de chanson au format de temps	Définit le format d’heure sur le pointeur de chanson (seizième notes). Toutes les commandes qui utilisent des valeurs de position supposent des unités de pointeur de chanson. Cet indicateur est valide uniquement pour une séquence de type de division PPQN.
format d’heure tmsf	Définit le format d’heure sur les pistes, les minutes, les secondes et les images. Toutes les commandes qui utilisent des valeurs de position supposent TMSF. Spécifiez une valeur TMSF comme tt:mm:ss:ff, où tt est suivi, mm est minutes, ss en secondes et ff est frames. Vous pouvez omettre un champ si celui-ci et tous les champs suivants sont zéro. Par exemple, 3, 3:0, 3:0:0 et 3:0:0:0 sont tous des moyens valides d’exprimer la piste 3. Les champs TMSF ont les valeurs maximales suivantes : Pistes 99 Minutes 90 Secondes 59 Images 74
suivi du format de temps	Définit le format de position sur les pistes. Toutes les commandes qui utilisent des valeurs de position supposent des pistes.
compteur de mode de temps	Définit le mode d’informations de position pour utiliser les compteurs vcR.
détection du mode de temps	Définit le mode d’informations de position en fonction de la détection des informations de timecode sur la bande. Si des informations de timecode sont détectées, le type d’heure est défini sur « timecode » ; sinon, le type d’heure est défini sur « compteur ». « Détecter » est un mode spécial. Chaque fois que le pilote est ouvert, une nouvelle bande est insérée ou la commande « mode de temps » est émise, le pilote vérifie le mode d’heure actuel disponible sur la bande et définit « time type » sur « timecode » ou « counter ». Une fois que le « type d’heure » est défini, le pilote ne le modifie pas tant que l’une des conditions ci-dessus ne se produit pas à nouveau.
time mode timecode	Définit le mode d’informations de position pour utiliser les informations « timecode » sur la bande.
suivi plus suivi moins Réinitialisation du suivi	Ajuste la vitesse du transport de la bande vidéo par incréments fins. Utilisez les indicateurs « suivi » lorsqu’une image bruyante est obtenue à partir d’un magnétoscope. « Tracking plus » augmente la vitesse de transport. Le « suivi moins » diminue la vitesse de transport. La « réinitialisation du suivi » renvoie l’ajustement du suivi à zéro.
vidéo désactivée	Désactive la sortie vidéo.
vidéo sur	Active la sortie vidéo.

lpszFlags

Peut être « attendre », « notifier » ou les deux. Pour les appareils de vidéo numérique et de magnétoscope, « test » peut également être spécifié. Pour plus d’informations sur ces indicateurs, consultez Les indicateurs d’attente, de notification et de test.

Valeur renvoyée

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

Notes

Plusieurs propriétés des données audio de forme d’onde sont définies lors de la création du fichier pour stocker les données. Ces propriétés décrivent comment les données sont structurées dans le fichier et ne peuvent pas être modifiées une fois l’enregistrement commencé. La liste suivante identifie ces propriétés :

• alignement
• bitspersample
• octetspersec
• channels
• balise format
• samplespersec

Exemples

La commande suivante définit le format de temps sur millisecondes et définit le format audio de forme d’onde sur 8 bits, mono, 11 kHz.

set mysound time format ms bitspersample 8 channels 1 samplespersec 11025

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]

Voir aussi

MCI

Chaînes de commande MCI

Capture

pause

enregistrer

stop