Commande save

Article
06/13/2023

La commande save enregistre un fichier MCI. Les appareils video-superposition 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 la prennent pas en charge.

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

_stprintf_s(
  lpszCommand, 
  TEXT("save %s %s %s"), 
  lpszDeviceID, 
  lpszFilename, 
  lpszFlags
);

Paramètres

lpszDeviceID

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

lpszFilename

Indicateur spécifiant le nom du fichier en cours d’enregistrement et, éventuellement, des indicateurs supplémentaires modifiant l’opération d’enregistrement. Le tableau suivant répertorie les types d’appareils qui reconnaissent la commande save et les indicateurs utilisés par chaque type.

Valeur	Signification	Signification
digitalvideo	abandonner au rectangle	filenamekeepreserve
superposition	au rectangle	filename
sequencer	filename
waveaudio	filename

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

Valeur	Signification
abort	Arrête une opération d’enregistrement en cours. S’il est utilisé, il doit s’agir du seul élément présent.
au rectangle	Spécifie un rectangle par rapport à l’origine de la mémoire tampon de trame. Le rectangle est spécifié sous la forme X1 Y1 X2 Y2. Les coordonnées X1 Y1 spécifient le coin supérieur gauche et les coordonnées X2 Y2 spécifient la largeur et la hauteur. Pour les appareils vidéo numériques, la commande de capture est utilisée pour capturer le contenu de la mémoire tampon de trame.
filename	Spécifie le nom de fichier à affecter au fichier de données. Si aucun chemin d’accès n’est spécifié, le fichier est placé sur le disque et dans le répertoire spécifié précédemment sur la commande de réserve explicite ou implicite. Si la réserve n’a pas été émise, le lecteur et le répertoire par défaut sont ceux associés à la tâche de l’application. Si un chemin d’accès est spécifié, l’appareil peut exiger qu’il se trouve sur le lecteur de disque spécifié par la réserve explicite ou implicite. Cet indicateur est obligatoire.
keepreserve	Spécifie que l’espace disque inutilisé de la commande de réserve d’origine n’est pas libéré.

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

La variable de nom de fichier est requise si l’appareil a été ouvert à l’aide du « nouvel » identificateur d’appareil.

Exemples

La commande suivante enregistre l’intégralité de la mémoire tampon vidéo dans un fichier nommé VCAPFILE. TGA.

save vboard c:\vcap\vcapfile.tga

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
Réserve

Partager via