commande MCI_DELETE

La commande MCI_DELETE supprime les données du fichier. Les appareils de vidéo numérique et d’audio de forme d’onde reconnaissent cette commande.

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

MCIERROR mciSendCommand(
  MCIDEVICEID wDeviceID, 
  MCI_DELETE, 
  DWORD dwFlags, 
  (DWORD) (LPMCI_GENERIC_PARMS) lpDelete
);

Paramètres

wDeviceID

Identificateur de l’appareil MCI devant recevoir le message de commande.

dwFlags

MCI_NOTIFY, MCI_WAIT ou, pour les appareils vidéo numériques, MCI_TEST. Pour plus d’informations sur ces indicateurs, consultez Indicateurs d’attente, de notification et de test.

lpDelete

Pointeur vers une structure MCI_GENERIC_PARMS . (Les appareils avec des jeux de commandes étendus 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

Les indicateurs suivants s’appliquent au type d’appareil digitalvideo :

MCI_DGV_DELETE_AT

Un rectangle est inclus dans le membre rc de la structure identifiée par lpDelete. Le rectangle spécifie la partie de chaque image à supprimer. Lorsque cet indicateur est utilisé, le cadre est conservé dans l’espace de travail et la zone spécifiée par le rectangle devient noire. Si l’indicateur est omis, MCI_DELETE utilise par défaut l’intégralité du cadre et supprime le cadre de l’espace de travail.

MCI_DGV_DELETE_AUDIO_STREAM

Un numéro de flux audio est inclus dans le membre dwAudioStream de la structure identifiée par lpDelete. Si vous utilisez cet indicateur et souhaitez également supprimer la vidéo, vous devez également utiliser l’indicateur MCI_DGV_DELETE_VIDEO_STREAM. (Si aucun indicateur n’est spécifié, les données de tous les flux audio et vidéo sont supprimées.)

MCI_DGV_DELETE_VIDEO_STREAM

Un numéro de flux vidéo est inclus dans le membre dwVideoStream de la structure identifiée par lpDelete. Si vous utilisez cet indicateur et que vous souhaitez également supprimer l’audio, vous devez également utiliser l’indicateur MCI_DGV_DELETE_AUDIO_STREAM. (Si aucun indicateur n’est spécifié, les données de tous les flux audio et vidéo sont supprimées.)

MCI_FROM

Un emplacement de départ est inclus dans le membre dwFrom de la structure identifiée par lpDelete. Les unités affectées aux valeurs de position sont spécifiées avec l’indicateur MCI_SET_TIME_FORMAT de la commande MCI_SET .

MCI_TO

Un emplacement de fin est inclus dans le membre dwTo de la structure identifiée par lpDelete. Les unités affectées aux valeurs de position sont spécifiées avec l’indicateur MCI_SET_TIME_FORMAT de MCI_SET.

Pour les appareils vidéo numériques, le paramètre lpDelete pointe vers une structure MCI_DGV_DELETE_PARMS .

Les indicateurs suivants s’appliquent au type d’appareil waveaudio :

MCI_FROM

Un emplacement de départ est inclus dans le membre dwFrom de la structure identifiée par lpDelete. Les unités affectées aux valeurs de position sont spécifiées avec l’indicateur MCI_SET_TIME_FORMAT de MCI_SET.

MCI_TO

Un emplacement de fin est inclus dans le membre dwTo de la structure identifiée par lpDelete. Les unités affectées aux valeurs de position sont spécifiées avec l’indicateur MCI_SET_TIME_FORMAT de MCI_SET.

Pour les appareils audio waveform, le paramètre lpDelete pointe vers une structure MCI_WAVE_DELETE_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