MCIWndCreateA 函数 (vfw.h)

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 字符串而不是 Unicode 字符串。 此标志与 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 在 MCIWnd 窗口标题栏中显示打开的 MCI 设备或数据文件的名称。
MCIWNDF_SHOWPOS 在窗口标题栏中显示 MCI 设备内容的当前位置。

szFile

以 Null 结尾的字符串,指示要打开的 MCI 设备或数据文件的名称。

返回值

如果成功,则返回 MCI 窗口的句柄,否则返回零。

注解

子窗口的默认窗口样式为WS_CHILD、WS_BORDER和WS_VISIBLE。 指定父窗口的非 NULL 句柄时,MCIWndCreate 假定子窗口。

父窗口的默认窗口样式为WS_OVERLAPPEDWINDOW和WS_VISIBLE。 指定父窗口的 NULL 句柄时,MCIWndCreate 假定父窗口。

将此函数返回的窗口句柄用于 MCIWnd 宏中的窗口句柄。 如果应用程序使用此函数,则无需使用 MCIWndRegisterClass 函数。

注意

vfw.h 标头将 MCIWndCreate 定义为别名,该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将非特定编码别名的使用与非非特定编码的代码混合使用可能会导致不匹配,从而导致编译或运行时错误。 有关详细信息,请参阅 函数原型的约定

要求

要求
最低受支持的客户端 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 vfw.h
Library Vfw32.lib
DLL Msvfw32.dll

另请参阅

MCIWNDM_NOTIFYMEDIA

MCIWNDM_NOTIFYMODE

MCIWNDM_NOTIFYPOS

MCIWndGetMode

MCIWndRegisterClass