Команда seek

Статья
06/13/2023

Команда seek перемещается в указанное положение и останавливается. Эта команда распознана на устройствах cd audio, digital-video, MIDI sequencer, VCR, videodisc и waveform-audio.

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

_stprintf_s(
  lpszCommand, 
  TEXT("seek %s %s %s"), 
  lpszDeviceID, 
  lpszSeekFlags, 
  lpszFlags
);

Параметры

lpszDeviceID

Идентификатор устройства MCI. Этот идентификатор или псевдоним назначается при открытии устройства.

lpszSeekFlags

Флаг для перемещения в указанную позицию. В следующей таблице перечислены типы устройств, которые распознают команду seek и флаги, используемые каждым типом.

Значение	Значение	Значение
cdaudio	до конца в положение	для запуска
digitalvideo	до конца в положение	для запуска
sequencer	до конца в положение	для запуска
Видео	времяпометка mark_numобратном	до конца до позициидля запуска
videodisc	обратный до конца	на позициюдля запуска
waveaudio	до конца в положение	для запуска

В следующей таблице перечислены флаги, которые можно указать в параметре lpszSeekFlags , и их значения.

Значение	Значение
в то время	Указывает, когда устройство должно начать выполнение этой команды или, если устройство было объявлено, когда начинается команда cued. Дополнительные сведения см. в разделе Команда подсказки .
пометить mark_num	Выполняет поиск относительной отметки, указанной mark_num, которая должна быть положительным целым числом. Метки — это сигналы, записанные на ленту VCR с помощью команды mark и используемые для высокоскоростного поиска.
reverse	Указывает, что направление поиска в видеодисках ВИДЕО и CAV обратно. Этот флаг недопустим, если указан флаг "to". Для VCR этот флаг должен использоваться с флагом "метка".
до конца	Ищет до конца содержимого.
на позицию	Указывает позицию для остановки поиска. Для устройств cdaudio MCI возвращает ошибку вне диапазона, если указанное положение больше длины диска.
для запуска	Стремится к началу содержимого.

lpszFlags

Может иметь значение "wait", "notify" или и то, и другое. Для цифровых видеоустройств и виртуальных машин также можно указать "test". Дополнительные сведения об этих флагах см. в разделе Флаги ожидания, уведомления и тестирования.

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

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

Устройства с цифровым видео поддерживают два режима поиска, которые можно изменить с помощью команды set . Режим "поиск точно в" приводит к переходу команды seek в указанный кадр. В режиме "поиск точно отключено" команда seek перемещается к ближайшему ключевому кадру до указанного кадра.

Если звуковое устройство компакт-диска воспроизводится при выполнении команды seek, воспроизведение останавливается. Когда команда поиска выполняется с устройством videodisc, устройство выполняет поиск с помощью быстрого перемотки вперед или обратного с выключением видео и звука.

Когда команда seek выполняется с устройством waveform-audio, поведение зависит от размера выборки. Если размер выборки составляет 16 бит или больше, поиск перемещается в начало ближайшей выборки, если указанная позиция не совпадает с началом выборки.

Примеры

Следующая команда выполняет поиск к началу файла мультимедиа, связанного с устройством mysound.

seek mysound to start

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]

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

MCI
Командные строки MCI
Cue
Марк
set