MCIWndCreateA 函数 (vfw.h)

MCIWndCreate 函数注册 MCIWnd 窗口类,并创建用于使用 MCI 服务的 MCIWnd 窗口。 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。 MCIWndCreate 在指定父窗口的 NULL 句柄时假定父窗口。

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

注意

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

要求

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

另请参阅

MCIWNDM_NOTIFYMEDIA

MCIWNDM_NOTIFYMODE

MCIWNDM_NOTIFYPOS

MCIWndGetMode

MCIWndRegisterClass