setaudio 命令

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

若要发送此命令，请使用 lpszCommand 参数集调用 mciSendString 函数，如下所示。

_stprintf_s(
  lpszCommand, 
  TEXT("setaudio %s %s %s"), 
  lpszDeviceID, 
  lpszAudio, 
  lpszFlags
); 

参数

lpszDeviceID

MCI 设备的标识符。 打开设备时会分配此标识符或别名。

lpszAudio

音频播放和捕获的标志。 下表列出了可识别 setaudio 命令的设备类型以及每种类型使用的标志。

值	含义	含义
digitalvideo	算法 算法对齐到 整数低音以 因子bitspersample 到 bit_count bytespersec 到 整数时钟时间输入左调到输出时 因因子关闭	超过 持续时间质量 描述符记录 off record on right off off right volume to factorsamplespersec to integersourcenamestream to numbertreble to factorvolume to factor
录像机	off on monitor to typenumber numberrecord off record track track_number off	记录在源上的记录跟踪track_number键入数字跟踪track_number偏离跟踪track_number打开

下表列出了可在 lpszAudio 参数中指定的标志及其含义。

值	含义
算法	选择供后续 保留 或 录制 命令使用的特定音频压缩算法。 支持的算法特定于设备。 MCI 定义 算法的值“g711”、“g721”、“g722”、“g728”、“pcm”、“cdxa”、“adpcm”和“adpcm4e”。 如果设备支持名为“pcm”、“cdxa”和“adpcm4e”的算法，则它们遵循标准定义。 “cdxa”算法由索尼公司定义。 “adpcm4e”算法由 Intel Corporation 定义。 “g711”、“g721”、“g722”和“g728”值代表国际电报和电话咨询委员会 (CCITT) 建议的音频算法。 如果指定的算法与当前文件格式冲突，则文件格式将更改为算法的默认格式。
对齐到 整数	设置数据块相对于输入波形音频数据的起始位置的对齐方式。
低音要 因数	设置音频低频级别。
bitspersample 到 bit_count	设置记录的每个样本的位数。 文件以此格式保存。 此标志仅适用于支持“pcm”算法的设备。
bytespersec 到 整数	设置每秒在“pcm”和“adpcm”算法中记录的平均字节数。 文件以此格式保存。
clocktime	指示在“over”标志中指定的时间以毫秒为单位。 这一次是绝对的，与工作区的播放不同步。
input	修改“低音”、“高音”或“音量”标志，使其影响输入信号并修改录制的内容。 如果可能，这是监视输入时的默认值。
left off left on	启用或禁用左侧声道上的音频输出。 音频演示源可以是外部输入或工作区。 默认值为“left on”。 如果只有一个通道，则打开或关闭该通道。
要考虑的左音量	设置左侧音频通道的音频音量。 如果只有一个通道，它将设置其音量。
监视器以 键入 number number	控制将传递到 VCR 输出的源输入，而无需更改记录源输入选择。 类型 可以是“输出”，也可以是有效的输入源之一。 如果未指定 number ，则将选择该类型的第一个输入。
off on	启用或禁用音频。 音频演示源可以是外部输入或工作区。 此命令同时影响左右音频通道。 默认值为 setaudio “on”。
output	修改“低音”、“高音”或“音量”标志，使其仅修改播放的信号，而不修改录制的内容。 如果可能，这是监视文件时的默认值。
持续时间	指定使用 因子 变量进行更改所需的时间。 持续时间的单位采用当前时间格式。 更改会随着工作区的播放而发生。 暂停播放时，更改也会暂停，直到播放继续。 如果未指定或不支持“over”，则更改会立即发生。
质量 描述符	指定将音频录制到文件时执行的音频压缩的特征。 所有设备都支持三个描述符“low”、“medium”和“high”。 默认值特定于设备。如果未指定“算法”标志，则“质量”调整将应用于当前算法。 quality 命令可用于定义其他描述符名称。
记录关闭	清除音频源选择，以便不会使用下一个录制命令录制任何 音频 。
记录在	启用音频数据的录制。 默认为录制音频数据。
记录 跟踪track_number 关闭	清除音频源选择，以便不会使用下一个录制命令录制任何 音频 。 “跟踪”允许独立选择曲目。 轨道 2 对应于 Hi8 中的 PCM 轨道。 如果未指定“track”，则假定默认值为 1。
记录跟踪track_number	选择要使用下一个录制命令录制的 音频 源。 “跟踪”允许独立选择曲目。 轨道 2 对应于 Hi8 中的 PCM 轨道。 如果未指定“track”，则假定默认值为 1。
right off right on	启用或禁用右声道上的音频输出。 音频演示源可以是外部输入或工作区。 默认值为“right on”。 如果只有一个通道，则此标志不起作用。
要考虑的右音量	将音频音量设置为正确的音频通道。 如果只有一个通道，则不起作用。
samplespersec 到 integer	使用“pcm”和“adpcm”算法设置录制的采样率。 文件以此格式保存。
source 到 sourcename	指定音频输入数字化器的来源。 为 sourcename 定义的常量包括：“left”、“right”、“average”和“stereo”。 前三个仅使用左输入、仅使用右输入和两个输入的平均值指定单音记录。
源以 键入 数字 编号	选择要在磁带上录制的音频源。 类型 必须为“tuner”、“line”、“svideo”、“aux”、“generic”或“mute”。
流到 数字	指定从工作区播放的音频流。 如果未指定流，并且文件格式未定义默认值，则将播放物理上第一个交错的音频流。
跟踪 track_number 关闭	禁用单个曲目。
跟踪track_number	启用单个曲目。
要分解的三重 音	设置音频高频率级别。
要因数的音量	设置两个音频通道的平均音频音量。 如果左卷和右卷已设置为不同的值，则左右卷的比率大致保持不变。

lpszFlags

可以是“等待”、“通知”、“测试”或这些组合。 有关这些标志的详细信息，请参阅 等待、通知和测试标志。

返回值

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

备注

对于 VCR 设备，将 setaudio 与关闭单个轨迹 (“跟踪 track_number 关闭”) 的标志结合使用可能会导致应用程序收到指示无法执行命令的状态消息。某些 VCR 只能关闭轨道的组合，而不能关闭单个轨道的组合;例如，第一个音频轨道和视频盒的视频轨。 在这种情况下，只需使用 setaudio 和 setvideo 继续关闭构成组合的其他曲目。 驱动程序在收到关闭组合中的最后一个音轨的命令时会关闭轨道。

要求

要求	值
最低受支持的客户端	Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器	Windows 2000 Server [仅限桌面应用]

另请参阅

Mci

MCI 命令字符串

record

保留

setvideo