команда MCI_SEEK

  • Статья

Команда MCI_SEEK как можно быстрее изменяет текущую позицию содержимого. Видео- и аудиовыходы отключены во время поиска. После завершения поиска устройство останавливается. Эта команда распознает аудиозаписи, цифровое видео, секвенсор MIDI, VCR, videodisc и waveform-audio.

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

MCIERROR mciSendCommand(
  MCIDEVICEID wDeviceID, 
  MCI_SEEK, 
  DWORD dwFlags, 
  (DWORD) (LPMCI_SEEK_PARMS) lpSeek
);

Параметры

wDeviceID

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

Dwflags

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

lpSeek

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

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

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

Комментарии

Если размер выборки данных для устройства больше 1 байта (например, для стереоданных waveform-audio), эта команда перемещается в начало ближайшей выборки, если указанная позиция не совпадает с началом образца.

Следующие дополнительные флаги применяются ко всем устройствам, поддерживающим MCI_SEEK:

MCI_SEEK_TO_END

Поиск до конца содержимого.

MCI_SEEK_TO_START

Поиск к началу содержимого.

MCI_TO

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

Следующие дополнительные флаги используются с типом устройства vcr :

MCI_VCR_SEEK_AT

Элемент dwAt структуры, определяемой lpSeek , содержит время начала всей команды.

MCI_VCR_SEEK_MARK

Элемент dwMark структуры, определяемой lpSeek , содержит нумерованную метку для поиска.

MCI_VCR_SEEK_REVERSE

Направление поиска обратное; используется только с флагом MCI_VCR_SEEK_MARK.

Для устройств VCR параметр lpSeek указывает на структуру MCI_VCR_SEEK_PARMS .

Следующий дополнительный флаг используется с типом устройства videodisc :

MCI_VD_SEEK_REVERSE

Направление поиска обратное.

Требования

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

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

MCI

Команды MCI