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] |