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	Mmsystem.h (inclure Windows.h)

Voir aussi

MCI

Commandes MCI