команда MCI_BREAK

  • Статья

Команда MCI_BREAK задает ключ останова для устройства MCI. MCI поддерживает эту команду напрямую, а не передает ее на устройство. Эту команду может использовать любое приложение MCI.

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

MCIERROR mciSendCommand(
  MCIDEVICEID wDeviceID, 
  MCI_BREAK, 
  DWORD dwFlags, 
  (DWORD) (LPMCI_BREAK_PARMS) lpBreak
);

Параметры

wDeviceID

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

Dwflags

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

lpBreak

Указатель на структуру MCI_ BREAK_PARMS .

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

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

Комментарии

Чтобы прервать операцию ожидания, может потребоваться несколько раз нажать клавишу останова. Нажатие клавиши останова после отмены ожидания устройства может отправить перерыв в приложение. Если приложение имеет действие, определенное для кода виртуального ключа, оно может непреднамеренно реагировать на прерывание. Например, приложение, использующее VK_CANCEL для клавиши ускорителя, может отвечать на клавиши CTRL+BREAK по умолчанию, если она нажата после отмены ожидания.

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

MCI_BREAK_HWND

Элемент hwndBreak структуры, определяемой lpBreak , содержит дескриптор окна, который должен быть текущим окном, чтобы включить обнаружение прерывания для этого устройства MCI. Обычно это окно main приложения. Если этот параметр опущен, MCI не проверка дескриптор окна текущего окна.

MCI_BREAK_KEY

Элемент nVirtKey структуры, определяемой lpBreak , указывает код виртуального ключа, используемый для ключа останова. По умолчанию MCI назначает сочетание клавиш CTRL+BREAK в качестве клавиши останова. Этот флаг является обязательным, если MCI_BREAK_OFF не указан.

MCI_BREAK_OFF

Отключает любой существующий ключ останова для указанного устройства.

Требования

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

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

MCI

Команды MCI