commande MCI_RESTORE

  • Article

La commande MCI_RESTORE copie une bitmap d’un fichier vers la mémoire tampon de trame. Les appareils vidéo numériques reconnaissent cette commande. Cette commande effectue l’action inverse de la commande MCI_CAPTURE .

Pour envoyer cette commande, appelez la fonction mciSendCommand avec les paramètres suivants.

MCIERROR mciSendCommand(
  MCIDEVICEID wDeviceID, 
  MCI_RESTORE, 
  DWORD dwFlags, 
  (DWORD) (LPMCI_DGV_RESTORE_PARMS) lpRestore
);

Paramètres

wDeviceID

Identificateur d’appareil de l’appareil MCI qui doit recevoir le message de commande.

dwFlags

MCI_NOTIFY, MCI_WAIT ou MCI_TEST. Pour plus d’informations sur ces indicateurs, consultez Les indicateurs d’attente, de notification et de test.

lpRestore

Pointeur vers une structure MCI_DGV_RESTORE_PARMS .

Valeur renvoyée

Retourne zéro en cas de réussite ou d’erreur dans le cas contraire.

Notes

L’implémentation peut reconnaître divers formats d’image, mais une bitmap indépendante de l’appareil (DIB) Windows est toujours acceptée.

Les indicateurs supplémentaires suivants s’appliquent aux appareils vidéo numériques :

MCI_DGV_RESTORE_FROM

Le membre lpstrFileName de la structure identifiée par lpRestore contient l’adresse d’une mémoire tampon contenant le nom de fichier source. Le nom de fichier est obligatoire.

MCI_DGV_RESTORE_AT

Le membre rc de la structure identifiée par lpRestore contient un rectangle valide. Le rectangle spécifie une région de la mémoire tampon de trame par rapport à son origine. 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. Si cet indicateur n’est pas spécifié, l’image est copiée dans le coin supérieur gauche de la mémoire tampon du cadre.

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