ACMFORMATTAGDETAILS 结构 (msacm.h)
ACMFORMATTAGDETAILS 结构详细介绍了 ACM 驱动程序的波形音频格式标记。
语法
typedef struct tACMFORMATTAGDETAILS {
DWORD cbStruct;
DWORD dwFormatTagIndex;
DWORD dwFormatTag;
DWORD cbFormatSize;
DWORD fdwSupport;
DWORD cStandardFormats;
char szFormatTag[ACMFORMATTAGDETAILS_FORMATTAG_CHARS];
} ACMFORMATTAGDETAILS, *PACMFORMATTAGDETAILS, *LPACMFORMATTAGDETAILS;
成员
cbStruct
ACMFORMATTAGDETAILS 结构的大小（以字节为单位）。 在应用程序调用 acmFormatTagDetails 或 acmFormatTagEnum 函数之前，必须初始化此成员。 此成员指定的大小必须足够大，才能包含基本 ACMFORMATTAGDETAILS 结构。 当 acmFormatTagDetails 函数返回时，此成员包含返回的信息的实际大小。 返回的信息永远不会超过请求的大小。
dwFormatTagIndex
将检索其详细信息的格式标记的索引。 索引的范围从零到比 ACM 驱动程序支持的格式标记数少一个。 驱动程序支持的格式标记数包含在 ACMDRIVERDETAILS 结构中。 仅当按索引查询驱动程序的格式标记详细信息时，才使用 dwFormatTagIndex 成员;否则，此成员应为零。
dwFormatTag
ACMFORMATTAGDETAILS 结构描述的波形音频格式标记。 此成员用于ACM_FORMATTAGDETAILSF_FORMATTAG和ACM_FORMATTAGDETAILSF_LARGESTSIZE查询标志的输入。 如果 acmFormatTagDetails 函数成功，则始终返回此成员。 对于所有其他查询标志，此成员应设置为WAVE_FORMAT_UNKNOWN。
cbFormatSize
dwFormatTag 类型的波形音频格式的最大总大小（以字节为单位）。 例如，对于 WAVE_FORMAT_PCM，此成员为 16，WAVE_FORMAT_ADPCM为 50。
fdwSupport
特定于格式标记的驱动程序支持标志。 这些标志与 ACMDRIVERDETAILS 结构相同。 此成员可以是以下值的某种组合，并引用驱动程序使用 format 标记支持的操作：
| 名称 | 说明 |
|---|---|
|
驱动程序支持使用指定的格式标记进行异步转换。 |
|
驱动程序支持在两个不同的格式标记之间进行转换，其中一个标记是指定的格式标记。 例如，如果驱动程序支持从WAVE_FORMAT_PCM压缩到WAVE_FORMAT_ADPCM，则会设置此标志。 |
|
驱动程序支持在指定格式标记的两种不同格式之间进行转换。 例如，如果驱动程序支持重新采样WAVE_FORMAT_PCM，则会设置此标志。 |
|
驱动程序支持筛选 (修改数据，而无需更改) 的任何格式属性。 例如，如果驱动程序支持对指定的格式标记执行卷或回显操作，则会设置此标志。 |
|
驱动程序通过波形音频设备支持硬件输入和/或输出指定的格式标记。 应用程序应将 acmMetrics 函数与ACM_METRIC_HARDWARE_WAVE_INPUT结合使用，并ACM_METRIC_HARDWARE_WAVE_OUTPUT指标索引来获取与支持 ACM 驱动程序关联的波形音频设备标识符。 |
cStandardFormats
dwFormatTag 类型的标准格式的数目;也就是说，所有采样率、每个样本的位数、通道等的组合。 此值可以指定驱动程序支持的所有格式，但不一定。
szFormatTag[ACMFORMATTAGDETAILS_FORMATTAG_CHARS]
描述 dwFormatTag 类型的字符串。 如果 acmFormatTagDetails 函数成功，则始终返回此字符串。
要求
| 最低受支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
| 最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
| 标头 | msacm.h |