commande MCI_PASTE

  • Article

La commande MCI_PASTE colle les données du Presse-papiers dans un fichier. Les appareils vidéo numériques reconnaissent cette commande.

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

MCIERROR mciSendCommand(
  MCIDEVICEID wDeviceID, 
  MCI_PASTE, 
  DWORD dwFlags, 
  (DWORD) (LPMCI_DGV_PASTE_PARMS) lpPaste
);

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.

lpPaste

Pointeur vers une structure PARMS MCI_ DGV_ PASTE_ .

Valeur renvoyée

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

Notes

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

MCI_DGV_PASTE_AT

Un rectangle est inclus dans le membre rc de la structure identifiée par lpPaste. Les deux premières valeurs du rectangle spécifient le point dans le cadre pour placer les informations du Presse-papiers. Si la hauteur et la largeur du rectangle ne sont pas nulles, le contenu du Presse-papiers est mis à l’échelle selon ces dimensions lorsqu’il est collé dans le cadre. Si l’indicateur est omis, MCI_PASTE est défini par défaut sur l’ensemble du rectangle de cadre.

MCI_DGV_PASTE_AUDIO_STREAM

Un numéro de flux audio est inclus dans le membre dwAudioStream de la structure identifiée par lpPaste. S’il n’existe qu’un seul flux audio dans le Presse-papiers, les données audio sont collées dans le flux désigné. S’il existe plusieurs flux audio dans le Presse-papiers, le flux indique le numéro de départ des séquences de flux. Si vous utilisez cet indicateur et souhaitez également coller une vidéo, vous devez également utiliser l’indicateur MCI_DGV_PASTE_VIDEO_STREAM. (Si aucun indicateur n’est spécifié, tous les flux audio et vidéo sont collés à partir du premier flux audio et vidéo. Chaque flux collé conserve son numéro de flux d’origine.)

MCI_DGV_PASTE_INSERT

Les données du Presse-papiers doivent être insérées dans l’espace de travail existant à la position spécifiée par l’indicateur MCI_TO. Toutes les données existantes après le point d’insertion sont déplacées dans l’espace de travail pour faire de la place. Il s’agit de la valeur par défaut.

MCI_DGV_PASTE_OVERWRITE

Les données du Presse-papiers doivent remplacer les données déjà présentes dans l’espace de travail. Les données de l’espace de travail remplacées suivent le point d’insertion.

MCI_DGV_PASTE_VIDEO_STREAM

Un numéro de flux vidéo est inclus dans le membre dwVideoStream de la structure identifiée par lpPaste. S’il n’existe qu’un seul flux vidéo dans le Presse-papiers, les données vidéo sont collées dans le flux désigné. S’il existe plusieurs flux vidéo dans le Presse-papiers, le flux indique le numéro de départ des séquences de flux. Si vous utilisez cet indicateur et souhaitez également coller l’audio, vous devez également utiliser l’indicateur MCI_DGV_PASTE_AUDIO_STREAM. (Si aucun indicateur n’est spécifié, tous les flux audio et vidéo sont collés à partir du premier flux audio et vidéo. Chaque flux collé conserve son numéro de flux d’origine.)

MCI_TO

Une valeur de position est incluse dans le membre dwTo de la structure identifiée par lpPaste. La valeur de position spécifie la position à laquelle commencer le collage des données dans l’espace de travail. Si cet indicateur est omis, la position par défaut est la position actuelle.

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