acmFilterTagEnum 函数枚举 ACM 驱动程序提供的波形音频筛选器标记。 此函数将继续枚举,直到没有更多合适的筛选器标记或回调函数返回 FALSE。
语法
MMRESULT ACMAPI acmFilterTagEnum(
HACMDRIVER had,
LPACMFILTERTAGDETAILS paftd,
ACMFILTERTAGENUMCB fnCallback,
DWORD_PTR dwInstance,
DWORD fdwEnum
);
参数
had
ACM 驱动程序的句柄,用于查询波形音频筛选器标记详细信息。 如果此参数为 NULL,则 ACM 将使用第一个合适的 ACM 驱动程序中的详细信息。
paftd
指向 ACMFILTERTAGDETAILS 结构的指针,该结构在传递给 fnCallback 函数时包含筛选器标记详细信息。 当应用程序调用 acmFilterTagEnum 时,必须初始化此结构的 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 |