ACMFORMATDETAILS 结构 (msacm.h)

项目
08/24/2023

ACMFORMATDETAILS 结构详细介绍了 ACM 驱动程序的特定格式标记的波形音频格式。

语法

typedef struct tACMFORMATDETAILS {
  DWORD          cbStruct;
  DWORD          dwFormatIndex;
  DWORD          dwFormatTag;
  DWORD          fdwSupport;
  LPWAVEFORMATEX pwfx;
  DWORD          cbwfx;
  char           szFormat[ACMFORMATDETAILS_FORMAT_CHARS];
} ACMFORMATDETAILS, *PACMFORMATDETAILS, *LPACMFORMATDETAILS;

成员

cbStruct

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

dwFormatIndex

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

dwFormatTag

ACMFORMATDETAILS 结构描述的波形音频格式标记。此成员用于ACM_FORMATDETAILSF_INDEX查询标志的输入。对于ACM_FORMATDETAILSF_FORMAT查询标志，此成员必须初始化为 与 pwfx 成员指定的格式标记相同的格式标记。如果对 acmFormatDetails 函数的调用成功，则始终返回此成员。对于所有其他查询标志，此成员应设置为WAVE_FORMAT_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	驱动程序通过波形音频设备支持指定格式的硬件输入和/或输出。应用程序应将 acmMetrics 与ACM_METRIC_HARDWARE_WAVE_INPUT和ACM_METRIC_HARDWARE_WAVE_OUTPUT指标索引一起使用，以获取与支持 ACM 驱动程序关联的波形音频设备标识符。

pwfx

指向将接收格式详细信息的 WAVEFORMATEX 结构的指针。此结构不需要应用程序初始化，除非在 acmFormatDetails 函数中指定了 ACM_FORMATDETAILSF_FORMAT 标志。在这种情况下，WAVEFORMATEX 结构的 wFormatTag 成员必须等于 ACMFORMATDETAILS 结构的 dwFormatTag。

cbwfx

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

szFormat[ACMFORMATDETAILS_FORMAT_CHARS]

描述 dwFormatTag 类型的格式的字符串。如果 acmFormatDetails 函数成功，则始终返回此字符串。

要求

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