acmFormatTagEnum 函数 (msacm.h)
acmFormatTagEnum 函数枚举 ACM 驱动程序提供的波形音频格式标记。 此函数继续枚举,直到没有更合适的格式标记或回调函数返回 FALSE。
语法
MMRESULT ACMAPI acmFormatTagEnum(
HACMDRIVER had,
LPACMFORMATTAGDETAILS paftd,
ACMFORMATTAGENUMCB fnCallback,
DWORD_PTR dwInstance,
DWORD fdwEnum
);
参数
had
ACM 驱动程序的句柄,用于查询波形音频格式标记详细信息。 如果此参数为 NULL,则 ACM 将使用第一个合适的 ACM 驱动程序中的详细信息。
paftd
指向 ACMFORMATTAGDETAILS 结构的指针,该结构用于接收传递给 fnCallback 中指定的函数的格式标记详细信息。 此结构必须已初始化 ACMFORMATTAGDETAILS 结构的 cbStruct 成员。
fnCallback
应用程序定义的回调函数的过程实例地址。
dwInstance
64 位 (DWORD_PTR) 或 32 位 (DWORD) 应用程序定义的值,该值连同 ACM 格式标记详细信息一起传递给回调函数。
fdwEnum
保留;必须为零。
返回值
如果成功,则返回零,否则返回错误。 可能的错误值包括以下内容。
返回代码 | 说明 |
---|---|
|
至少有一个标志无效。 |
|
指定的句柄无效。 |
|
至少有一个参数无效。 |
注解
如果未安装合适的 ACM 驱动程序,此函数将返回零MMSYSERR_NOERROR () 。 此外,不会调用回调函数。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
目标平台 | Windows |
标头 | msacm.h |
Library | Msacm32.lib |
DLL | Msacm32.dll |