команда 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 [только классические приложения] |
| Заголовок |
|