commande MCI_SAVE
La commande MCI_SAVE enregistre le fichier actif. Les appareils qui modifient des fichiers ne doivent pas détruire la copie d’origine tant qu’ils n’ont pas reçu le message d’enregistrement. Les périphériques audio de superposition vidéo et de forme d’onde 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 mciSendCommand avec les paramètres suivants.
MCIERROR mciSendCommand(
MCIDEVICEID wDeviceID,
MCI_SAVE,
DWORD dwFlags,
(DWORD) (LPMCI_SAVE_PARMS ) lpSave
);
Paramètres
-
wDeviceID
-
Identificateur de l’appareil MCI devant recevoir le message de commande.
-
dwFlags
-
MCI_NOTIFY, MCI_WAIT ou, pour les appareils de vidéo numérique et de magnétoscope, MCI_TEST. Pour plus d’informations sur ces indicateurs, consultez Indicateurs d’attente, de notification et de test.
-
lpSave
-
Pointeur vers une structure MCI_SAVE_PARMS . (Les appareils avec des paramètres supplémentaires peuvent remplacer cette structure par une structure spécifique à l’appareil.)
Valeur renvoyée
Retourne zéro en cas de réussite ou une erreur dans le cas contraire.
Notes
Cette commande est prise en charge par les appareils qui retournent TRUE lorsque vous appelez la commande MCI_GETDEVCAPS avec l’indicateur MCI_GETDEVCAPS_CAN_SAVE.
L’indicateur supplémentaire suivant s’applique à tous les appareils prenant en charge MCI_SAVE :
-
MCI_SAVE_FILE
-
Le membre lpfilename de la structure identifiée par lpSave contient l’adresse d’une mémoire tampon contenant le nom de fichier de destination.
Les indicateurs supplémentaires suivants sont utilisés avec le type d’appareil digitalvideo :
-
MCI_DGV_RECT
-
Le membre rc de la structure identifiée par lpSave contient un rectangle valide. Le rectangle spécifie une région de la mémoire tampon de trame qui sera enregistrée dans le fichier spécifié. La première paire de coordonnées spécifie le coin supérieur gauche du rectangle ; la deuxième paire spécifie la largeur et la hauteur. Les appareils vidéo numériques doivent utiliser la commande MCI_CAPTURE pour capturer le contenu de la mémoire tampon de trame. (Les appareils de superposition vidéo doivent également utiliser MCI_CAPTURE.) Cet indicateur est destiné à la compatibilité avec le jeu de commandes de superposition vidéo MCI existant.
-
MCI_DGV_SAVE_ABORT
-
Arrête une opération d’enregistrement en cours. Il doit s’agir du seul indicateur présent.
-
MCI_DGV_SAVE_KEEPRESERVE
-
L’espace disque inutilisé de la commande MCI_RESERVE d’origine n’est pas libéré.
Pour les appareils vidéo numériques, le paramètre lpSave pointe vers une structure MCI_DGV_SAVE_PARMS .
L’indicateur supplémentaire suivant est utilisé avec le type d’appareil de superposition :
-
MCI_OVLY_RECT
-
Le membre rc de la structure identifiée par lpSave contient un rectangle d’affichage valide indiquant la zone de la mémoire tampon vidéo à enregistrer.
Pour les appareils de superposition vidéo, le paramètre lpSave pointe vers une structure MCI_OVLY_SAVE_PARMS .
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] |
| En-tête |
|