commande record

La commande d’enregistrement démarre l’enregistrement des données. Les appareils vcr et waveform-audio reconnaissent cette commande. Bien que les périphériques vidéo numériques et les séquenceurs MIDI reconnaissent également cette commande, les pilotes MCIAVI et MCISEQ ne l’implémentent pas.

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

_stprintf_s(
  lpszCommand, 
  TEXT("record %s %s %s"), 
  lpszDeviceID, 
  lpszRecordFlags, 
  lpszFlags
); 

Paramètres

lpszDeviceID

Identificateur d’un appareil MCI. Cet identificateur ou alias est attribué lorsque l’appareil est ouvert.

lpszRecordFlags

Indicateur pour l’enregistrement des données. Le tableau suivant répertorie les types d’appareils qui reconnaissent la commande d’enregistrement et les indicateurs utilisés par chaque type.

Valeur	Signification	Signification
digitalvideo	au niveau du flux audio rectangleà partir de la positionde maintien	insérer un remplacement pour positionner leflux de flux vidéo
sequencer	à partir de l’insertion de position	remplacer pour positionner
Magnétoscope	au momentde l’initialisation de la position	insérer un remplacement pour la position
waveaudio	à partir de l’insertion de position	remplacer pour positionner

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

Valeur	Signification
au rectangle	Spécifie une région rectangulaire de l’entrée externe utilisée comme source pour les pixels compressés et enregistrés. S’il n’est pas spécifié, le rectangle est défini par défaut sur le rectangle spécifié pour put « video ». Lorsqu’elle est définie différemment du rectangle « vidéo », l’image affichée n’est pas celle qui est enregistrée.
à l’heure	Indique quand l’appareil doit commencer à exécuter cette commande ou, si l’appareil a été cued, quand la commande cued commence. Pour plus d’informations, consultez la commande cue .
flux de flux audio	Spécifie le flux audio utilisé pour l’enregistrement. Si cet indicateur n’est pas spécifié et que le format de fichier ne définit pas de valeur par défaut, il est enregistré dans le flux physiquement premier.
à partir de la position	Spécifie une position de départ pour l’enregistrement. Si l’indicateur « de » n’est pas spécifié, l’appareil démarre l’enregistrement à la position actuelle.
Tenir	Fige l’image lorsque l’enregistrement est terminé au lieu d’afficher la vidéo en direct. Lorsque l’enregistrement s’arrête, une commande automatique de supervision « file » est exécutée. Pour revenir à la vidéo en direct, émettez la commande « entrée » du moniteur.
initialize	Initialisez la bande (média), ce qui implique l’enregistrement du timecode (si possible) pour la vidéo et l’audio vides. Cette commande peut prendre plusieurs heures si la bande entière doit être initialisée.
insert	Spécifie que de nouvelles données sont ajoutées au fichier à la position actuelle.
overwrite	Spécifie que les nouvelles données remplaceront les données dans le fichier.
à positionner	Spécifie une position de fin pour l’enregistrement. Si l’indicateur « à » n’est pas spécifié, l’appareil enregistre jusqu’à ce qu’il reçoive une commande d’arrêt ou de pause .
flux vidéo	Spécifie le flux vidéo utilisé pour l’enregistrement. Si ce n’est pas spécifié et que le format de fichier ne définit pas de valeur par défaut, il est enregistré dans le flux physiquement en premier.

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

L’enregistrement s’arrête lorsqu’une commande d’arrêt ou de pause est émise. Pour le pilote MCIWAVE, toutes les données enregistrées après l’ouverture d’un fichier sont ignorées si le fichier est fermé sans l’enregistrer.

Avant d’émettre des commandes qui utilisent des valeurs de position, vous devez définir le format de temps souhaité à l’aide de la commande set . Les pistes à enregistrer sont spécifiées par les commandes settimecode « record », set « assemble record », setvideo « record » et setaudio « record ».

Exemples

La commande suivante démarre l’enregistrement à la position actuelle.

record mysound

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

Indice

Moniteur

pause

Mettre

set

setaudio

settimecode

setvideo

stop