ACMFILTERDETAILS 结构 (msacm.h)

项目
08/24/2023

ACMFILTERDETAILS 结构详细介绍了 ACM 驱动程序的特定筛选器标记的波形音频筛选器。

语法

typedef struct tACMFILTERDETAILS {
  DWORD        cbStruct;
  DWORD        dwFilterIndex;
  DWORD        dwFilterTag;
  DWORD        fdwSupport;
  LPWAVEFILTER pwfltr;
  DWORD        cbwfltr;
  char         szFilter[ACMFILTERDETAILS_FILTER_CHARS];
} ACMFILTERDETAILS, *PACMFILTERDETAILS, *LPACMFILTERDETAILS;

成员

cbStruct

ACMFILTERDETAILS 结构的大小（以字节为单位）。在调用 acmFilterDetails 或 acmFilterEnum 函数之前，必须初始化此成员。此成员中指定的大小必须足够大，才能包含基本 ACMFILTERDETAILS 结构。当 acmFilterDetails 函数返回时，此成员包含返回的信息的实际大小。返回的信息永远不会超过请求的大小。

dwFilterIndex

筛选器的索引，该索引将检索哪些详细信息。索引的范围从 0 到 1，比筛选器标记的 ACM 驱动程序支持的标准筛选器数少一个。驱动程序支持的筛选器标记的标准筛选器数包含在 ACMFILTERTAGDETAILS 结构中。 dwFilterIndex 成员仅在按索引查询有关驱动程序的标准筛选器详细信息时使用;否则，此成员应为零。此外，当应用程序查询筛选器的详细信息时，ACM 会将此成员设置为零;换句话说，此成员仅用于输入，并且永远不会由 ACM 或 ACM 驱动程序返回。

dwFilterTag

ACMFILTERDETAILS 结构描述的波形音频筛选器标记。此成员用作ACM_FILTERDETAILSF_INDEX查询标志的输入。对于ACM_FILTERDETAILSF_FORMAT查询标志，必须将此成员初始化为 pwfltr 成员指定的同一筛选器标记。如果 acmFilterDetails 函数成功，则始终返回此成员。对于所有其他查询标志，此成员应设置为 WAVE_FILTER_UNKNOWN。

fdwSupport

特定于指定筛选器的驱动程序支持标志。这些标志与 ACMDRIVERDETAILS 结构相同，但它们特定于正在查询的筛选器。此成员可以是以下值的组合，并标识驱动程序支持筛选器标记的操作：

名称	说明
ACMDRIVERDETAILS_SUPPORTF_ASYNC	驱动程序支持异步转换。
ACMDRIVERDETAILS_SUPPORTF_CODEC	驱动程序支持在使用指定筛选器时在两个不同的格式标记之间进行转换。例如，如果驱动程序支持使用指定的筛选器从WAVE_FORMAT_PCM压缩到WAVE_FORMAT_ADPCM，则会设置此标志。
ACMDRIVERDETAILS_SUPPORTF_CONVERTER	驱动程序支持在使用指定筛选器时在同一格式标记的两种不同格式之间进行转换。例如，如果驱动程序支持使用指定的筛选器重新采样WAVE_FORMAT_PCM，则会设置此标志。
ACMDRIVERDETAILS_SUPPORTF_FILTER	驱动程序支持筛选 (修改数据，而无需更改任何格式属性) 。例如，如果驱动程序支持WAVE_FORMAT_PCM上的卷或回显操作，则会设置此标志。
ACMDRIVERDETAILS_SUPPORTF_HARDWARE	驱动程序支持通过波形音频设备使用指定筛选器的硬件输入和/或输出。应用程序应使用具有ACM_METRIC_HARDWARE_WAVE_INPUT和ACM_METRIC_HARDWARE_WAVE_OUTPUT指标索引的 acmMetrics 函数来检索与支持 ACM 驱动程序关联的波形音频设备标识符。

pwfltr

指向将接收筛选器详细信息的 WAVEFILTER 结构的指针。除非使用 acmFilterDetails 函数指定了 ACM_FILTERDETAILSF_FILTER 标志，否则此结构不需要应用程序进行初始化。在这种情况下，WAVEFILTER 结构的 dwFilterTag 成员必须等于 ACMFILTERDETAILS 结构的 dwFilterTag 成员。

cbwfltr

可用于 pwfltr 接收筛选器详细信息的大小（以字节为单位）。 acmMetrics 和 acmFilterTagDetails 函数可用于确定指定驱动程序 (或所有已安装的 ACM 驱动程序) 所需的最大大小。

szFilter[ACMFILTERDETAILS_FILTER_CHARS]

描述 dwFilterTag 类型的筛选器的字符串。如果 acmFilterDetails 函数成功，则始终返回此字符串。

要求


最低受支持的客户端	Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器	Windows 2000 Server [仅限桌面应用]
标头	msacm.h