acmFilterDetails 函数 (msacm.h)
acmFilterDetails 函数查询 ACM,以获取有关具有特定波形音频筛选器标记的筛选器的详细信息。
语法
MMRESULT ACMAPI acmFilterDetails(
HACMDRIVER had,
LPACMFILTERDETAILS pafd,
DWORD fdwDetails
);
parameters
had
ACM 驱动程序的句柄,用于查询筛选器标记的波形音频筛选器详细信息。 如果此参数为 NULL,则 ACM 将使用第一个合适的 ACM 驱动程序中的详细信息。
pafd
指向 ACMFILTERDETAILS 结构的指针,该结构用于接收给定筛选器标记的筛选器详细信息。
fdwDetails
用于获取详细信息的标志。 定义了以下值。
[ACMFILTERDETAILS] () 结构已给定,应返回其余详细信息。 必须将 ACMFILTERDETAILS 结构的 dwFilterTag 成员初始化为 pwfltr 指定的相同筛选器标记。 此查询类型可用于获取任意筛选器结构的字符串说明。 如果应用程序为 had 指定了 ACM 驱动程序句柄,则会为该驱动程序返回有关筛选器的详细信息。 如果应用程序为 had 指定 NULL,则 ACM 会查找第一个可接受的驱动程序来返回详细信息。值 | 含义 |
---|---|
ACM_FILTERDETAILSF_FILTER | |
ACM_FILTERDETAILSF_INDEX | 在 ACMFILTERDETAILS 结构的 dwFilterIndex 成员中提供了筛选器标记的筛选器索引。 筛选器详细信息将在 pafd 定义的结构中返回。 索引范围从零到 1,比筛选器标记的 ACMFILTERTAGDETAILS 结构中返回的 cStandardFilters 成员少一个。 使用此标志检索筛选器详细信息时,应用程序必须为 had 指定驱动程序句柄。 有关在调用此函数之前应初始化哪些成员的信息,请参阅 ACMFILTERDETAILS 结构。 |
返回值
如果成功,则返回零,否则返回错误。 可能的错误值包括以下内容。
返回代码 | 说明 |
---|---|
|
请求的详细信息不可用。 |
|
至少有一个标志无效。 |
|
指定的句柄无效。 |
|
至少有一个参数无效。 |
要求
最低受支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
目标平台 | Windows |
标头 | msacm.h |
Library | Msacm32.lib |
DLL | Msacm32.dll |