acmMetrics 函数 (msacm.h)
acmMetrics 函数返回 ACM 或相关 ACM 对象的各种指标。
语法
MMRESULT ACMAPI acmMetrics(
HACMOBJ hao,
UINT uMetric,
LPVOID pMetric
);
parameters
hao
要查询 uMetric 中指定的指标的 ACM 对象的句柄。 对于某些查询，此参数可以为 NULL。
uMetric
pMetric 中要返回的指标索引。
| 值 | 含义 |
|---|---|
| ACM_METRIC_COUNT_CODECS | 返回的值是系统中全局 ACM 压缩器或解压缩器驱动程序的数目。 对于此指标索引， hao 参数必须为 NULL 。 pMetric 参数必须指向大小等于 DWORD 值的缓冲区。 |
| ACM_METRIC_COUNT_CONVERTERS | 返回的值是系统中的全局 ACM 转换器驱动程序的数目。 对于此指标索引， hao 参数必须为 NULL 。 pMetric 参数必须指向大小等于 DWORD 值的缓冲区。 |
| ACM_METRIC_COUNT_DISABLED | 返回的值是系统中) 的所有支持类型的全局禁用 ACM 驱动程序 (总数。 对于此指标索引， hao 参数必须为 NULL 。 pMetric 参数必须指向大小等于 DWORD 值的缓冲区。 ACM_METRIC_COUNT_DRIVERS和ACM_METRIC_COUNT_DISABLED指标索引之和是全局安装的 ACM 驱动程序总数。 |
| ACM_METRIC_COUNT_DRIVERS | 返回的值是系统中) 的所有支持类型 (已启用的全局 ACM 驱动程序总数。 对于此指标索引， hao 参数必须为 NULL 。 pMetric 参数必须指向大小等于 DWORD 值的缓冲区。 |
| ACM_METRIC_COUNT_FILTERS | 返回的值是系统中的全局 ACM 筛选器驱动程序的数目。 对于此指标索引， hao 参数必须为 NULL 。 pMetric 参数必须指向大小等于 DWORD 值的缓冲区。 |
| ACM_METRIC_COUNT_HARDWARE | 返回的值是系统中全局 ACM 硬件驱动程序的数目。 对于此指标索引， hao 参数必须为 NULL 。 pMetric 参数必须指向大小等于 DWORD 值的缓冲区。 |
| ACM_METRIC_COUNT_LOCAL_CODECS | 返回的值是调用任务的本地 ACM 压缩器驱动程序和/或 ACM 解压缩器驱动程序的数目。 对于此指标索引， hao 参数必须为 NULL 。 pMetric 参数必须指向大小等于 DWORD 值的缓冲区。 |
| ACM_METRIC_COUNT_LOCAL_CONVERTERS | 返回的值是调用任务的本地 ACM 转换器驱动程序数。 对于此指标索引， hao 参数必须为 NULL 。 pMetric 参数必须指向大小等于 DWORD 值的缓冲区。 |
| ACM_METRIC_COUNT_LOCAL_DISABLED | 返回的值是调用任务的所有支持类型的本地禁用 ACM 驱动程序的总数。 对于此指标索引， hao 参数必须为 NULL 。 pMetric 参数必须指向大小等于 DWORD 值的缓冲区。 ACM_METRIC_COUNT_LOCAL_DRIVERS和ACM_METRIC_COUNT_LOCAL_DISABLED指标索引之和是本地安装的 ACM 驱动程序总数。 |
| ACM_METRIC_COUNT_LOCAL_DRIVERS | 返回的值是调用任务) 的所有支持类型的已启用本地 ACM 驱动程序 (总数。 对于此指标索引， hao 参数必须为 NULL 。 pMetric 参数必须指向大小等于 DWORD 值的缓冲区。 |
| ACM_METRIC_COUNT_LOCAL_FILTERS | 返回的值是调用任务的本地 ACM 筛选器驱动程序数。 对于此指标索引， hao 参数必须为 NULL 。 pMetric 参数必须指向大小等于 DWORD 值的缓冲区。 |
| ACM_METRIC_DRIVER_PRIORITY | 返回的值是指定驱动程序的当前优先级。 hao 参数必须是 HACMDRIVERID 数据类型的有效 ACM 驱动程序标识符。 pMetric 参数必须指向大小等于 DWORD 值的缓冲区。 |
| ACM_METRIC_DRIVER_SUPPORT | 返回的值是指定驱动程序的 fdwSupport 标志。 hao 参数必须是 HACMDRIVERID 数据类型的有效 ACM 驱动程序标识符。 pMetric 参数必须指向大小等于 DWORD 值的缓冲区。 |
| ACM_METRIC_HARDWARE_WAVE_INPUT | 返回的值是与指定驱动程序关联的波形音频输入设备标识符。 hao 参数必须是支持 ACMDRIVERDETAILS_SUPPORTF_HARDWARE 标志的 HACMDRIVERID 数据类型的有效 ACM 驱动程序标识符。 如果没有波形音频输入设备与驱动程序关联，则返回MMSYSERR_NOTSUPPORTED。 pMetric 参数必须指向大小等于 DWORD 值的缓冲区。 |
| ACM_METRIC_HARDWARE_WAVE_OUTPUT | 返回的值是与指定驱动程序关联的波形音频输出设备标识符。 hao 参数必须是支持 ACMDRIVERDETAILS_SUPPORTF_HARDWARE 标志的 HACMDRIVERID 数据类型的有效 ACM 驱动程序标识符。 如果没有波形音频输出设备与驱动程序相关联，则返回MMSYSERR_NOTSUPPORTED。 pMetric 参数必须指向大小等于 DWORD 值的缓冲区。 |
| ACM_METRIC_MAX_SIZE_FILTER | 返回的值是最大的 WAVEFILTER 结构的大小。 如果 hao 为 NULL，则返回值是系统中最大的 WAVEFILTER 结构。 如果 hao 标识了 HACMDRIVER 数据类型的 ACM 驱动程序的打开实例或 HACMDRIVERID 数据类型的 ACM 驱动程序标识符，则返回该驱动程序的最大 WAVEFILTER 结构。 pMetric 参数必须指向大小等于 DWORD 值的缓冲区。 HACMSTREAM 数据类型的 ACM 流句柄不允许使用此指标。 |
| ACM_METRIC_MAX_SIZE_FORMAT | 返回的值是最大的 WAVEFORMATEX 结构的大小。 如果 hao 为 NULL，则返回值是系统中最大的 WAVEFORMATEX 结构。 如果 hao 标识了 HACMDRIVER 数据类型的 ACM 驱动程序的打开实例或 HACMDRIVERID 数据类型的 ACM 驱动程序标识符，则返回该驱动程序的最大 WAVEFORMATEX 结构。 pMetric 参数必须指向大小等于 DWORD 值的缓冲区。 HACMSTREAM 数据类型的 ACM 流句柄不允许使用此指标。 |
pMetric
指向用于接收指标详细信息的缓冲区的指针。 确切的定义取决于 uMetric 索引。
返回值
如果成功，则返回零，否则返回错误。 可能的错误值包括以下内容。
| 返回代码 | 说明 |
|---|---|
|
不能为指定的 hao 返回在 uMetric 中指定的索引。 |
|
指定的句柄无效。 |
|
至少有一个参数无效。 |
|
不支持 在 uMetric 中指定的索引。 |
要求
| 最低受支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
| 最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
| 目标平台 | Windows |
| 标头 | msacm.h |
| Library | Msacm32.lib |
| DLL | Msacm32.dll |