команда MCI_DELETE

  • Статья

Команда MCI_DELETE удаляет данные из файла. Эта команда распознает устройства digital-video и waveform-audio.

Чтобы отправить эту команду, вызовите функцию mciSendCommand со следующими параметрами.

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

Параметры

wDeviceID

Идентификатор устройства MCI, которое получает сообщение команды.

Dwflags

MCI_NOTIFY, MCI_WAIT или для цифровых видеоустройств MCI_TEST. Сведения об этих флагах см. в разделе Флаги ожидания, уведомления и тестирования.

lpDelete

Указатель на структуру MCI_GENERIC_PARMS . (Устройства с расширенными наборами команд могут заменить эту структуру структурой для конкретного устройства.)

Возвращаемое значение

Возвращает ноль в случае успешного выполнения или ошибку в противном случае.

Комментарии

Следующие флаги применяются к типу устройства digitalvideo :

MCI_DGV_DELETE_AT

Прямоугольник включается в rc-член структуры, определяемой lpDelete. Прямоугольник указывает часть каждого кадра, который требуется удалить. При использовании этого флага рамка сохраняется в рабочей области, а область, указанная прямоугольником, становится черной. Если флаг не указан, MCI_DELETE по умолчанию используется весь фрейм и удаляет его из рабочей области.

MCI_DGV_DELETE_AUDIO_STREAM

Номер аудиопотока включается в элемент dwAudioStream структуры, определяемой lpDelete. Если вы используете этот флаг и хотите удалить видео, необходимо также использовать флаг MCI_DGV_DELETE_VIDEO_STREAM. (Если ни один из флагов не указан, данные из всех аудио- и видеопотоков удаляются.)

MCI_DGV_DELETE_VIDEO_STREAM

Номер видеопотока включается в элемент dwVideoStream структуры, определяемой lpDelete. Если вы используете этот флаг и хотите удалить звук, необходимо также использовать флаг MCI_DGV_DELETE_AUDIO_STREAM. (Если ни один из флагов не указан, данные из всех аудио- и видеопотоков удаляются.)

MCI_FROM

Начальное расположение включается в элемент dwFrom структуры, определяемой lpDelete. Единицы измерения, назначенные значениям позиций, указываются с помощью флага MCI_SET_TIME_FORMAT команды MCI_SET .

MCI_TO

Конечное расположение включается в элемент dwTo структуры, определяемой lpDelete. Единицы измерения, назначенные значениям позиции, указываются с флагом MCI_SET_TIME_FORMAT MCI_SET.

Для цифровых видеоустройств параметр lpDelete указывает на структуру MCI_DGV_DELETE_PARMS .

Следующие флаги применяются к типу устройства waveaudio :

MCI_FROM

Начальное расположение включается в элемент dwFrom структуры, определяемой lpDelete. Единицы измерения, назначенные значениям позиции, указываются с помощью флага MCI_SET_TIME_FORMAT MCI_SET.

MCI_TO

Конечное расположение включается в элемент dwTo структуры, определяемой lpDelete. Единицы измерения, назначенные значениям позиции, указываются с флагом MCI_SET_TIME_FORMAT MCI_SET.

Для устройств waveform-audio параметр lpDelete указывает на структуру MCI_WAVE_DELETE_PARMS .

Требования

Требование Значение
Минимальная версия клиента
 Windows 2000 Professional [только классические приложения]
Минимальная версия сервера
 Windows 2000 Server [только классические приложения]
Заголовок
Mmsystem.h (включая Windows.h)

См. также раздел

MCI

Команды MCI