MCI_SETAUDIO 命令

MCI_SETAUDIO 命令设置与音频播放和捕获关联的值。 数字视频和 VCR 设备可识别此命令。

若要发送此命令，请使用以下参数调用 mciSendCommand 函数。

MCIERROR mciSendCommand(
  MCIDEVICEID wDeviceID, 
  MCI_SETAUDIO, 
  DWORD dwFlags, 
  (DWORD) (LPMCI_GENERIC_PARMS) lpSetAudio
);

parameters

wDeviceID

要接收命令消息的 MCI 设备的设备标识符。

dwFlags

MCI_NOTIFY、MCI_WAIT或MCI_TEST。 有关这些标志的信息，请参阅 等待、通知和测试标志。

lpSetAudio

指向 MCI_GENERIC_PARMS 结构的指针。 具有扩展命令集 (设备可能会将此结构替换为特定于设备的结构。)

返回值

如果成功，则返回零，否则返回错误。

备注

以下标志适用于 数字视频 设备类型：

MCI_DGV_SETAUDIO_ALG

由 lpSetAudio 标识的 结构的 lpstrAlgorithm 成员包含缓冲区的地址，该地址包含音频压缩算法的名称。 压缩算法由后续 MCI_RESERVE 或 MCI_RECORD 命令使用。 可用的算法依赖于设备。 如果算法与当前文件格式不兼容，则文件格式将更改为算法的默认格式。

MCI_DGV_SETAUDIO_CLOCKTIME

指定的时间以毫秒为单位，与 MCI_DGV_SETAUDIO_OVER 一起使用时是绝对时间。 (这次与工作区的玩法不同步。)

MCI_DGV_SETAUDIO_INPUT

修改低音、高音或音量标志，使其影响输入信号并修改录制的内容。 如果可能，这是监视输入时的默认值。

MCI_DGV_SETAUDIO_ITEM

音频常量在 lpSetAudio 标识的结构的 dwItem 成员中指定。 常量标识正在设置的值。 定义了以下常量：

MCI_DGV_SETAUDIO_AVGBYTESPERSEC

平均字节数在 lpSetAudio 标识的 结构的 dwValue 成员中指定。 此值设置 PCM (脉冲编码调制) 和 ADPCM (自适应差分编码调制) 格式中播放或录制的平均字节数。 文件以此格式保存。

MCI_DGV_SETAUDIO_BASS

音频低频级别指定为 lpSetAudio 标识的结构的 dwValue 成员中的一个因子。

MCI_DGV_SETAUDIO_BITSPERSAMPLE

每个样本的位数在 lpSetAudio 标识的 结构的 dwValue 成员中指定。 此值设置以 PCM 格式播放或记录的每个样本的位数。 文件以此格式保存。

MCI_DGV_SETAUDIO_BLOCKALIGN

数据块对齐方式在 lpSetAudio 标识的 结构的 dwValue 成员中指定。 此值设置数据块相对于输入波形数据的起始位置的对齐方式。

MCI_DGV_SETAUDIO_SAMPLESPERSEC

采样率在 lpSetAudio 标识的 结构的 dwValue 成员中指定。 此值设置使用 PCM 和 ADPCM 算法播放和录制的采样率。 文件以此格式保存。

MCI_DGV_SETAUDIO_SOURCE

指定音频输入源的常量包含在由 lpSetAudio 标识的 结构的 dwValue 成员中。 为音频输入源定义了以下常量：

MCI_DGV_SETAUDIO_SOURCE_AVERAGE

左右音频声道的平均值。

MCI_DGV_SETAUDIO_SOURCE_LEFT

左音频通道。

MCI_DGV_SETAUDIO_SOURCE_RIGHT

右音频通道。

MCI_DGV_SETAUDIO_SOURCE_STEREO

立体。

MCI_DGV_SETAUDIO_STREAM

音频流在 lpSetAudio 标识的 结构的 dwValue 成员中指定。 整数值指定从工作区播放的音频流。 如果未指定流，则播放第一个物理交错音频流。

MCI_DGV_SETAUDIO_TREBLE

音频高频率级别指定为 lpSetAudio 标识的结构的 dwValue 成员中的一个因子。

MCI_DGV_SETAUDIO_VOLUME

一个或两个音频通道的音频级别指定为 lpSetAudio 标识的结构的 dwValue 成员中的一个因子。 如果左卷和右卷已设置为不同的值，则左右卷的比率大致保持不变。

MCI_DGV_SETAUDIO_LEFT

与 MCI_SET_ON 一起使用时，启用左侧音频通道。 与 MCI_SET_OFF 一起使用时禁用左侧音频通道。 当此标志与MCI_DGV_SETAUDIO_VALUE和MCI_DGV_SETAUDIO_VOLUME的组合一起使用时，它将设置左侧音频声道的音量。 当此标志与 MCI_DGV_SETAUDIO_SOURCE 一起使用时，它会指定左侧音频通道作为音频输入数字化器的来源。

MCI_DGV_SETAUDIO_OVER

转换长度参数包含在由 lpSetAudio 标识的 结构的 dwOver 成员中。 length 值指定 (的时长（以当前时间格式为单位) 进行使用因子的更改）。 如果未使用此标志，将立即发生更改。

MCI_DGV_SETAUDIO_QUALITY

由 lpSetAudio 标识的 结构的 lpstrQuality 成员包含定义音频质量的缓冲区的地址。 缓冲区中的文本字符串指定音频压缩算法的特征。

MCI_DGV_SETAUDIO_ALG标志可用于为指定算法选择质量描述符。 如果省略此标志，则使用当前算法。

可用的算法和描述符名称取决于设备。 每个设备都提供可用算法的文档以及适用的描述符名称的说明。 MCI_QUALITY 命令可以定义其他描述符名称。

MCI_DGV_SETAUDIO_RECORD

指定录制是包含还是排除音频数据。 与 MCI_SET_ON 结合使用时，将记录音频数据。 与 MCI_SET_OFF 结合使用时，将排除音频数据。 默认值包括音频数据。

MCI_DGV_SETAUDIO_RIGHT

与 MCI_SET_ON 一起使用时启用正确的音频通道。 与 MCI_SET_OFF 一起使用时，禁用正确的音频通道。 当此标志与 MCI_DGV_SETAUDIO_VALUE 和 MCI_DGV_SETAUDIO_VOLUME 的组合一起使用时，它将设置右侧音频声道的音量。

MCI_DGV_SETAUDIO_VALUE

值在 lpSetAudio 标识的结构的 dwValue 成员中指定。 值的含义由为 MCI_DGV_SETAUDIO_ITEM 标志定义的常量指定。

MCI_SET_OFF

禁用指定的音频通道。

MCI_SET_ON

启用指定的音频通道。

MCI_SETAUDIO_OUTPUT

修改低音、高音或音量标志，使其仅修改播放的信号，而不修改录制的内容。 如果可能，这是监视输入时的默认值。

对于数字视频设备， lpSetAudio 参数指向 MCI_DGV_SETAUDIO_PARMS 结构。

以下附加标志用于 vcr 设备类型：

MCI_VCR_SETAUDIO_RECORD

将音频录制设置为“打开”或“关闭”，这与以下标志之一结合使用：

MCI_SET_ON

音频录制打开。

MCI_SET_OFF

音频录制关闭。 可能需要先使用 MCI_SET 命令关闭汇编录制 (，MCI_VCR_SET_ASSEMBLE_RECORD标志设置为关闭) ，然后才能关闭音频录制。

MCI_TRACK

由 lpSetAudio 标识的结构的 dwTrack 成员指定受命令影响的轨道。

MCI_VCR_SETAUDIO_SOURCE

设置音频源。 此标志必须与 MCI_VCR_SETAUDIO_TO 标志一起使用。

MCI_VCR_SETAUDIO_MONITOR

设置音频源监视器。 此标志必须与 MCI_VCR_SETAUDIO_TO 标志一起使用。

MCI_VCR_SETAUDIO_TO

由 lpSetAudio 标识的结构的 dwTo 成员包含描述输入或受监视输入类型的常量。 必须是下列其中一项：

MCI_VCR_SRC_TYPE_TUNER

类型为 tuner。

MCI_VCR_SRC_TYPE_LINE

类型为 line。

MCI_VCR_SRC_TYPE_AUX

类型是辅助的。

MCI_VCR_SRC_TYPE_GENERIC

类型为泛型。

MCI_VCR_SRC_TYPE_MUTE

类型为静音。 这只能与 MCI_VCR_SETAUDIO_SOURCE 标志一起使用。

MCI_VCR_SRC_TYPE_OUTPUT

类型为输出。

MCI_VCR_SETAUDIO_NUMBER

由 lpSetAudio 标识的结构的 dwNumber 成员包含要使用的 dwTo 成员) 中指定的类型的音频输入 (。

对于 VCR 设备， lpSetAudio 参数指向 MCI_VCR_SETAUDIO_PARMS 结构。

要求

要求	值
最低受支持的客户端	Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器	Windows 2000 Server [仅限桌面应用]
标头	Mmsystem.h (包括 Windows.h)

另请参阅

Mci

MCI 命令