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