acmFilterTagDetails 函数 (msacm.h)

  • 项目

acmFilterTagDetails 函数查询 ACM，了解有关特定波形音频筛选器标记的详细信息。

语法

MMRESULT ACMAPI acmFilterTagDetails(
  HACMDRIVER            had,
  LPACMFILTERTAGDETAILS paftd,
  DWORD                 fdwDetails
);

参数

had

用于查询波形音频筛选器标记详细信息的 ACM 驱动程序的句柄。 如果此参数为 NULL，ACM 将使用第一个合适的 ACM 驱动程序中的详细信息。 使用ACM_FILTERTAGDETAILSF_INDEX查询类型时，应用程序必须指定有效的 HACMDRIVER 或 HACMDRIVERID 标识符。 不允许禁用驱动程序的驱动程序标识符。

paftd

指向用于接收筛选器标记详细信息的 ACMFILTERTAGDETAILS 结构的指针。

fdwDetails

获取详细信息的标志。 定义了以下值。

[ACMFILTERTAGDETAILS] () 结构。 筛选器标记详细信息将在 paftd 指向的结构中返回。 如果应用程序指定 了 ACM 驱动程序句柄，则会为该驱动程序返回筛选器标记的详细信息。 如果应用程序指定了 NULL，则 ACM 会查找第一个可接受的驱动程序来返回详细信息。 [ACMDRIVERDETAILS] (./nf-msacm-acmdriverdetails.md) ACM 驱动程序的结构。 应用程序必须在使用此标志检索筛选器标记 详细信息时为其 指定驱动程序句柄。
Value 含义
ACM_FILTERTAGDETAILSF_FILTERTAG
ACM_FILTERTAGDETAILSF_INDEX
ACM_FILTERTAGDETAILSF_LARGESTSIZE 将返回包含最大筛选器大小的筛选器标记的详细信息（以字节为单位）。 dwFilterTag 成员必须WAVE_FILTER_UNKNOWN或筛选器标记才能查找其最大大小。 如果应用程序指定 了 ACM 驱动程序句柄，则会为该驱动程序返回最大筛选器标记的详细信息。 如果应用程序指定了 NULL，ACM 将找到一个可接受的驱动程序，其中包含请求返回详细信息的最大筛选器标记。

返回值

如果成功，则返回零;否则返回错误。 可能的错误值包括以下内容。

返回代码 说明
ACMERR_NOTPOSSIBLE
 请求的详细信息不可用。
MMSYSERR_INVALFLAG
 至少有一个标志无效。
MMSYSERR_INVALHANDLE
 指定的句柄无效。
MMSYSERR_INVALPARAM
 至少有一个参数无效。

要求

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

另请参阅

音频压缩函数

音频压缩管理器