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