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

Статья
11/20/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 Профессиональный [только классические приложения]
минимальный поддерживаемый сервер	Windows 2000 Server [только классические приложения]
целевая платформа	Виндоус
заголовка	vfw.h
библиотеки	Vfw32.lib
DLL	Msvfw32.dll

См. также

Поделиться через