acmMetrics 函数 (msacm.h)

项目
08/24/2023

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 索引。

返回值

如果成功，则返回零，否则返回错误。可能的错误值包括以下内容。

返回代码	说明
ACMERR_NOTPOSSIBLE	不能为指定的 hao 返回在 uMetric 中指定的索引。
MMSYSERR_INVALHANDLE	指定的句柄无效。
MMSYSERR_INVALPARAM	至少有一个参数无效。
MMSYSERR_NOTSUPPORTED	不支持在 uMetric 中指定的索引。

要求


最低受支持的客户端	Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器	Windows 2000 Server [仅限桌面应用]
目标平台	Windows
标头	msacm.h
Library	Msacm32.lib
DLL	Msacm32.dll

另请参阅

音频压缩函数

音频压缩管理器

acmMetrics 函数 (msacm.h)

语法

parameters

返回值

要求

另请参阅

反馈

反馈

其他资源