команда signal

  • Статья

Команда signal определяет указанную позицию в рабочей области, отправляя приложению сообщение MM_MCISIGNAL . Цифровые видеоустройства распознают эту команду. MCIAVI поддерживает только один активный сигнал одновременно.

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

_stprintf_s(
  lpszCommand, 
  TEXT("signal %s %s %s"), 
  lpszDeviceID, 
  lpszSignalFlags, 
  lpszFlags
);

Параметры

lpszDeviceID

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

lpszSignalFlags

Один из следующих флагов.

Значение Значение
в позиции Указывает кадр для вызова сигнала.
cancel Удаляет сигналы из рабочей области. Отдельный сигнал указывается с помощью флага uservalue. Если флаг uservalue не указан с помощью параметра cancel, устройство отменяет все сигналы. Флаг "отмена" несовместим с флагами "at", "every" и "return position".
каждый интервал Указывает период сигналов. Значение интервала указывается в формате текущего времени. При использовании с позицией "at" сигналы помещаются по всей рабочей области с одной сигнальной меткой, размещенной в позиции.
Без флага "at" сигналы размещаются по всей рабочей области с одним сигналом в текущей позиции.
Если этот флаг опущен, помечается только позиция, указанная флагом "at".
Если значение интервала меньше минимальной частоты, поддерживаемой устройством, оно будет использовать его минимальное значение.
позиция возврата Указывает, что устройство должно отправлять значение позиции вместо идентификатора uservalue в сигнальном сообщении. Идентификатор uservalue по-прежнему можно использовать для отмены или переопределиния сигнальных меток.
uservalue id Указывает идентификатор, который передается вместе с сигнальным сообщением. Этот идентификатор выступает в качестве идентификатора, который можно использовать с другими командами сигнала для ссылки на этот параметр сигнала . Если этот параметр опущен, значение по умолчанию равно нулю.

lpszFlags

Это может быть "ожидание", "уведомление", "тест" или их сочетание. Дополнительные сведения об этих флагах см. в разделе Флаги ожидания, уведомления и тестирования.

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

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

Комментарии

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

Требования

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

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

MCI

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

MM_MCISIGNAL