commande MCI_RESTORE
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 |
|