ACMFORMATENUMCB 回调函数 (msacm.h)

  • 项目

acmFormatEnumCallback 函数指定与 acmFormatEnum 函数一起使用的回调函数。 acmFormatEnumCallback 名称是应用程序定义的函数名称的占位符。

语法

ACMFORMATENUMCB Acmformatenumcb;

BOOL Acmformatenumcb(
  HACMDRIVERID hadid,
  LPACMFORMATDETAILS pafd,
  DWORD_PTR dwInstance,
  DWORD fdwSupport
)
{...}

parameters

hadid

ACM 驱动程序标识符的句柄。

pafd

指向 ACMFORMATDETAILS 结构的指针，该结构包含格式标记的枚举格式详细信息。

dwInstance

在 acmFormatEnum 函数中指定的应用程序定义值。

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 驱动程序关联的波形音频设备标识符。

返回值

回调函数必须返回 TRUE 才能继续枚举，返回 FALSE 才能停止枚举。

注解

如果未枚举任何格式， 则 acmFormatEnum 函数将返回MMSYSERR_NOERROR (零) 。 此外，不会调用回调函数。

不应从回调函数中调用以下函数： acmDriverAdd、 acmDriverRemove 和 acmDriverPriority。

要求

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

另请参阅

音频压缩函数

音频压缩管理器