Save, commande

La commande Save enregistre un fichier MCI. Les périphériques vidéo-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 le 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, les indicateurs supplémentaires qui modifient 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 niveau du rectangle nom de fichier keepreserve
superposition au niveau du rectangle extension
sequencer extension
WaveAudio extension

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 niveau du rectangle Spécifie un rectangle par rapport à l’origine de la mémoire tampon du frame. Le rectangle est spécifié en tant que x1 Y1 x2 Y2. Les coordonnées x1 Y1 spécifient l’angle supérieur gauche et les coordonnées x2 Y2 spécifient la largeur et la hauteur. Pour les périphériques vidéo numériques, la commande de capture est utilisée pour capturer le contenu de la mémoire tampon de trame.
extension Spécifie le nom de fichier à assigner 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 dans 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é à partir de la commande de réserve d’origine n’est pas libéré.

lpszFlags

Peut être « Wait », « Notify », ou les deux. Pour les appareils vidéo numériques et VCR, vous pouvez également spécifier « test ». 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 une erreur.

Remarques

La variable filename est requise si l’appareil a été ouvert à l’aide de l’identificateur de périphérique « New ».

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

attire

reserve