(msacm.h) 的 ACMDRIVERDETAILS 结构
ACMDRIVERDETAILS 结构描述了 ACM 驱动程序的功能。
语法
typedef struct tACMDRIVERDETAILS {
DWORD cbStruct;
FOURCC fccType;
FOURCC fccComp;
WORD wMid;
WORD wPid;
DWORD vdwACM;
DWORD vdwDriver;
DWORD fdwSupport;
DWORD cFormatTags;
DWORD cFilterTags;
HICON hicon;
char szShortName[ACMDRIVERDETAILS_SHORTNAME_CHARS];
char szLongName[ACMDRIVERDETAILS_LONGNAME_CHARS];
char szCopyright[ACMDRIVERDETAILS_COPYRIGHT_CHARS];
char szLicensing[ACMDRIVERDETAILS_LICENSING_CHARS];
char szFeatures[ACMDRIVERDETAILS_FEATURES_CHARS];
} ACMDRIVERDETAILS, *PACMDRIVERDETAILS, *LPACMDRIVERDETAILS;
成员
cbStruct
ACMDRIVERDETAILS 结构中包含的有效信息的大小（以字节为单位）。 应用程序应将此成员初始化为所需信息的大小（以字节为单位）。 此成员中指定的大小必须足够大，才能包含 ACMDRIVERDETAILS 结构的 cbStruct 成员。 当 acmDriverDetails 函数返回时，此成员包含返回的信息的实际大小。 返回的信息永远不会超过请求的大小。
fccType
驱动程序的类型。 对于 ACM 驱动程序，将此成员设置为 ACMDRIVERDETAILS_FCCTYPE_AUDIOCODEC。
fccComp
驱动程序的子类型。 此成员当前设置为ACMDRIVERDETAILS_FCCCOMP_UNDEFINED (零) 。
wMid
制造商标识符。 制造商标识符在 制造商和产品标识符中定义。
wPid
产品标识符。 产品标识符在 制造商和产品标识符中定义。
vdwACM
为其编译此驱动程序的 ACM 的版本。 版本号是0xAABBCCCC格式的十六进制数字，其中 AA 是主版本号，BB 是次要版本号，CCCC 是内部版本号。 版本部分 (主要、次要和内部版本) 应显示为十进制数。
vdwDriver
驱动程序的版本。 版本号是0xAABBCCCC格式的十六进制数字，其中 AA 是主版本号，BB 是次要版本号，CCCC 是内部版本号。 版本部分 (主要、次要和内部版本) 应显示为十进制数。
fdwSupport
驱动程序的支持标志。 定义了以下值：
| 名称 | 说明 |
|---|---|
|
驱动程序支持异步转换。 |
|
驱动程序支持在两个不同的格式标记之间进行转换。 例如，如果驱动程序支持从WAVE_FORMAT_PCM压缩到WAVE_FORMAT_ADPCM，则会设置此标志。 |
|
驱动程序支持在同一格式标记的两种不同格式之间进行转换。 例如，如果驱动程序支持重新采样WAVE_FORMAT_PCM，则会设置此标志。 |
|
驱动程序已被禁用。 如果出于多种原因而被禁用，则此标志由驱动程序的 ACM 设置。 禁用的驱动程序无法打开，只能在非常有限的情况下使用。 |
|
驱动程序支持筛选 (修改数据，而无需更改) 的任何格式属性。 例如，如果驱动程序支持WAVE_FORMAT_PCM上的音量或回显操作，则会设置此标志。 |
|
驱动程序通过波形音频设备支持硬件输入和/或输出。 应用程序应将 acmMetrics 函数与ACM_METRIC_HARDWARE_WAVE_INPUT结合使用，并ACM_METRIC_HARDWARE_WAVE_OUTPUT指标索引来获取与支持 ACM 驱动程序关联的波形音频设备标识符。 |
|
驱动程序已针对当前任务在本地安装。 |
cFormatTags
此驱动程序支持的唯一格式标记数。
cFilterTags
此驱动程序支持的唯一筛选器标记数。
hicon
此驱动程序的自定义图标的句柄。 应用程序可以使用此图标直观地引用驱动程序。 此成员可以为 NULL。
szShortName[ACMDRIVERDETAILS_SHORTNAME_CHARS]
以 Null 结尾的字符串，用于描述驱动程序的名称。 此字符串旨在以小空格显示。
szLongName[ACMDRIVERDETAILS_LONGNAME_CHARS]
以 Null 结尾的字符串，用于描述驱动程序的全名。 此字符串旨在以大 (描述性) 空格显示。
szCopyright[ACMDRIVERDETAILS_COPYRIGHT_CHARS]
以 Null 结尾的字符串，为驱动程序提供版权信息。
szLicensing[ACMDRIVERDETAILS_LICENSING_CHARS]
以 Null 结尾的字符串，为驱动程序提供特殊许可信息。
szFeatures[ACMDRIVERDETAILS_FEATURES_CHARS]
以 Null 结尾的字符串，为驱动程序提供特殊功能信息。
要求
| 最低受支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
| 最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
| 标头 | msacm.h |