acmDriverMessage 函数 (msacm.h)

  • 项目

acmDriverMessage 函数将用户定义的消息发送到给定的 ACM 驱动程序实例。

语法

LRESULT ACMAPI acmDriverMessage(
  HACMDRIVER had,
  UINT       uMsg,
  LPARAM     lParam1,
  LPARAM     lParam2
);

parameters

had

消息将发送到的 ACM 驱动程序实例的句柄。

uMsg

ACM 驱动程序必须处理的消息。 此消息必须位于ACMDM_USER消息范围内， (大于或等于 ACMDM_USER 且小于 ACMDM_RESERVED_LOW) 。 此限制的例外情况是ACMDM_DRIVER_ABOUT、 DRV_QUERYCONFIGURE和 DRV_CONFIGURE 消息。

lParam1

消息参数。

lParam2

消息参数。

返回值

返回值特定于由 uMsg 参数指定的用户定义的 ACM 驱动程序消息。 但是，可能的错误值包括以下内容。

返回代码 说明
MMSYSERR_INVALHANDLE
 指定的句柄无效。
MMSYSERR_INVALPARAM
 uMsg 参数不在ACMDM_USER范围内。
MMSYSERR_NOTSUPPORTED
 ACM 驱动程序未处理消息。

注解

若要显示 ACM 驱动程序中的自定义“关于”对话框，应用程序必须将ACMDM_DRIVER_ABOUT消息发送到驱动程序。 lParam1 参数应为自定义“关于”对话框的所有者窗口的句柄，并且 lParam2 必须设置为零。 如果驱动程序不支持自定义的“关于”对话框，则将返回MMSYSERR_NOTSUPPORTED，应用程序负责显示其自己的对话框。 例如，当 ACM 驱动程序返回MMSYSERR_NOTSUPPORTED时，控制面板声音映射器选项将显示基于 ACMDRIVERDETAILS 结构的默认“关于”对话框。 通过将 lParam1 设置为 –1L ，应用程序可以查询驱动程序以获取自定义的“关于”对话框支持，而无需显示对话框。 如果驱动程序支持自定义的“关于”对话框，则将返回MMSYSERR_NOERROR。 否则，返回值MMSYSERR_NOTSUPPORTED。

用户定义的消息只能发送到专门支持这些消息的 ACM 驱动程序。 调用方应通过检索驱动程序详细信息并检查 ACMDRIVERDETAILS 结构的 wMid、wPid 和 vdwDriver 成员来验证 ACM 驱动程序是否是正确的驱动程序。

切勿将用户定义的消息发送到未知的 ACM 驱动程序。

要求

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

另请参阅

音频压缩函数

音频压缩管理器