Partager via


commande restore

La commande restore copie une image fixe d’un fichier vers la mémoire tampon de trame. Il s’agit de l’inverse de la commande de capture . Les appareils vidéo numériques reconnaissent cette commande.

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

_stprintf_s(
  lpszCommand, 
  TEXT("restore %s %s %s"), 
  lpszDeviceID, 
  lpszRestore, 
  lpszFlags
); 

Paramètres

lpszDeviceID

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

lpszRestore

Un ou plusieurs des indicateurs suivants.

Valeur Signification
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. Si cet indicateur n’est pas utilisé, l’image est copiée dans le coin supérieur gauche de la mémoire tampon du cadre.
à partir du nom de fichier Spécifie le nom de fichier de l’image à rappeler. Cet indicateur est obligatoire.

lpszFlags

Il peut s’agir de « wait », « notify », « test » ou d’une combinaison de ceux-ci. 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

Les appareils peuvent reconnaître divers formats d’image ; une bitmap indépendante de l’appareil Windows est toujours reconnue.

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