错误消息和通知

MCIWnd 使用 MCI 来控制播放和记录多媒体数据的设备。 通常,MCIWnd 在错误对话框中显示 MCI 错误。 每当 MCI 命令失败时,将生成 MCI 错误。 例如,如果应用程序尝试使用 MCIWndResume 宏恢复暂停播放,并且当前设备不支持恢复,则会向用户报告错误。

MCIWnd 允许两种用于处理错误消息的选项:

  • 可以阻止错误消息到达用户。 若要防止显示 MCI 错误消息,请在使用 MCIWndCreateCreateWindowEx 函数创建 MCIWnd 窗口实例时指定MCIWNDF_NOERRORDLG窗口样式。
  • 可以将它们重定向到应用程序进行显示。 若要将 MCI 错误消息重定向到应用程序,请在使用 MCIWndCreateCreateWindowEx 创建 MCIWnd 窗口实例时指定MCIWNDF_NOTIFYERROR窗口样式。

启用错误通知后,MCIWnd 会将每个通知消息 (MCIWNDM_NOTIFYERROR) 发送到 MCIWnd 窗口父级的主消息处理程序。 应用程序必须具有消息处理程序来处理它收到的通知消息。

可以使用 MCIWndGetError 宏获取最新 MCI 错误消息的文本说明。 此宏返回应用程序定义的缓冲区中的文本。 如果错误字符串比缓冲区长,MCIWnd 会截断字符串。

可以使用 MCIWndSetOwner 宏将所有通知路由到另一个窗口。