Функция MCIWndCreateA (vfw.h)

Статья
03/03/2024

Функция MCIWndCreate регистрирует класс окна MCIWnd и создает окно MCIWnd для использования служб MCI. MCIWndCreate также может открыть устройство или файл MCI (например, AVI-файл) и связать их с окном MCIWnd.

Синтаксис

HWND VFWAPIV MCIWndCreateA(
  HWND      hwndParent,
  HINSTANCE hInstance,
  DWORD     dwStyle,
  LPCSTR    szFile
);

Параметры

hwndParent

Дескриптор родительского окна.

hInstance

Обработка экземпляра модуля для связывания с окном MCIWnd.

dwStyle

Флаги, определяющие стиль окна. Помимо указания стилей окон, используемых с функцией CreateWindowEx , можно указать следующие стили для использования с окнами MCIWnd.

Значение	Значение
MCIWNDF_NOAUTOSIZEWINDOW	Не изменяет размеры окна MCIWnd при изменении размера изображения.
MCIWNDF_NOAUTOSIZEMOVIE	Не изменяет размеры прямоугольника назначения при изменении размера окна MCIWnd.
MCIWNDF_NOERRORDLG	Блокирует отображение ошибок MCI для пользователей.
MCIWNDF_NOMENU	Скрывает кнопку Меню в представлении на панели инструментов и запрещает пользователям доступ к ее всплывающему меню.
MCIWNDF_NOOPEN	Скрывает команды открытия и закрытия из меню MCIWnd и запрещает пользователям доступ к этим вариантам во всплывающем меню.
MCIWNDF_NOPLAYBAR	Скрывает панель инструментов из представления и запрещает пользователям доступ к ней.
MCIWNDF_NOTIFYANSI	Заставляет MCIWnd использовать строку ANSI вместо строки Юникода при уведомлении родительского окна об изменениях режима устройства. Этот флаг используется в сочетании с MCIWNDF_NOTIFYMODE.
MCIWNDF_NOTIFYMODE	Заставляет MCIWnd уведомлять родительское окно с сообщением MCIWNDM_NOTIFYMODE при каждом изменении режима работы устройства. Параметр lParam этого сообщения определяет новый режим, например MCI_MODE_STOP.
MCIWNDF_NOTIFYPOS	Заставляет MCIWnd уведомлять родительское окно MCIWNDM_NOTIFYPOS сообщением при изменении положения воспроизведения или записи в содержимом. Параметр lParam этого сообщения содержит новую позицию в содержимом.
MCIWNDF_NOTIFYMEDIA	Заставляет MCIWnd уведомлять родительское окно MCIWNDM_NOTIFYMEDIA сообщением при каждом использовании нового устройства или открытии или закрытии файла данных. Параметр lParam этого сообщения содержит указатель на новое имя файла.
MCIWNDF_NOTIFYSIZE	Заставляет MCIWnd уведомлять родительское окно при изменении размера окна MCIWnd.
MCIWNDF_NOTIFYERROR	Вызывает уведомление MCIWnd в родительском окне при возникновении ошибки MCI.
MCIWNDF_NOTIFYALL	Вызывает использование всех стилей уведомлений окна MCIWNDF.
MCIWNDF_RECORD	Добавляет кнопку Запись на панель инструментов и новую команду файла в меню, если устройство MCI имеет возможность записи.
MCIWNDF_SHOWALL	Вызывает использование всех MCIWNDF_SHOW стилей.
MCIWNDF_SHOWMODE	Отображает текущий режим устройства MCI в строке заголовка окна. Список режимов устройства см. в макросе MCIWndGetMode .
MCIWNDF_SHOWNAME	Отображает имя открытого устройства или файла данных MCI в строке заголовка окна MCIWnd.
MCIWNDF_SHOWPOS	Отображает текущую позицию в содержимом устройства MCI в строке заголовка окна.

szFile

Строка, завершающаяся значением NULL, указывающая имя устройства MCI или файла данных для открытия.

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

Возвращает дескриптор в окно MCI в случае успеха или ноль в противном случае.

Стили по умолчанию для дочернего окна: WS_CHILD, WS_BORDER и WS_VISIBLE. MCIWndCreate предполагает наличие дочернего окна при указании дескриптора родительского окна, отличного от NULL .

Стили окон по умолчанию для родительского окна : WS_OVERLAPPEDWINDOW и WS_VISIBLE. MCIWndCreate предполагает родительское окно при указании дескриптора NULL родительского окна.

Используйте дескриптор окна, возвращенный этой функцией, для дескриптора окна в макросах MCIWnd. Если приложение использует эту функцию, ему не нужно использовать функцию MCIWndRegisterClass .

Примечание

Заголовок vfw.h определяет MCIWndCreate как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Сочетание использования псевдонима, не зависящий от кодировки, с кодом, не зависящим от кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	vfw.h
Библиотека	Vfw32.lib
DLL	Msvfw32.dll

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