команда MCI_WINDOW

  • Статья

Команда MCI_WINDOW определяет окно и характеристики окна для графических устройств. Устройства цифрового видео и наложения видео распознают эту команду.

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

MCIERROR mciSendCommand(
  MCIDEVICEID wDeviceID, 
  MCI_WINDOW, 
  DWORD dwFlags, 
  (DWORD) (LPMCI_GENERIC_PARMS) lpWindow
);

Параметры

wDeviceID

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

Dwflags

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

lpWindow

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

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

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

Комментарии

Графические устройства должны создавать окно по умолчанию при открытии устройства, но не должны отображать его, пока они не получат команду MCI_PLAY . Команда MCI_WINDOW используется для предоставления созданного приложением окна устройству и изменения характеристик отображения определенного приложением или окна отображения по умолчанию. Если приложение предоставляет окно отображения, оно должно быть готово к обновлению недопустимого прямоугольника в окне.

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

MCI_DGV_WINDOW_HWND

Дескриптор окна, необходимого для использования в качестве назначения, включается в элемент hWnd структуры, определяемой lpWindow.

MCI_DGV_WINDOW_STATE

Элемент nCmdShow структуры, определяемой lpWindow , содержит параметры для настройки состояния окна.

MCI_DGV_WINDOW_TEXT

Элемент lpstrText структуры, определяемой lpWindow, содержит адрес буфера, содержащий подпись, используемый в строке заголовка окна.

Для цифровых видеоустройств параметр lpWindow указывает на структуру MCI_DGV_WINDOW_PARMS .

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

MCI_OVLY_WINDOW_DISABLE_STRETCH

Отключает растяжение изображения.

MCI_OVLY_WINDOW_ENABLE_STRETCH

Включает растяжение изображения.

MCI_OVLY_WINDOW_HWND

Дескриптор окна, используемого для назначения, включается в элемент hWnd структуры, определяемой lpWindow. Установите для этого флага значение MCI_OVLY_WINDOW_DEFAULT, чтобы вернуться к окну по умолчанию.

MCI_OVLY_WINDOW_STATE

Элемент nCmdShow структуры lpWindow содержит параметры для настройки состояния окна. Этот флаг эквивалентен вызову ShowWindow с параметром state . Константы совпадают с теми, которые определены в WINDOWS. H (например, SW_HIDE, SW_MINIMIZE или SW_SHOWNORMAL).

MCI_OVLY_WINDOW_TEXT

Элемент lpstrText структуры, определяемой lpWindow, содержит адрес буфера, содержащий подпись, используемый для окна.

Для устройств с наложением видео параметр lpWindow указывает на структуру MCI_OVLY_WINDOW_PARMS .

Требования

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

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

MCI

Команды MCI