status 命令

  • 项目

注意

无偏差通信 Microsoft 支持多样化且包容的环境。 在本文档中，有对单词“slave”的引用。 Microsoft 的 《Bias-Free通信风格指南》 将此视为排除词。 使用此措辞，因为它是命令中当前使用的措辞。 为了保持一致性，本文档包含此单词。 在命令中更改此单词时，我们将更正此文档以保持一致。

状态命令从设备请求状态信息。 所有设备都识别此命令。

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

_stprintf_s(
  lpszCommand,
  TEXT("status %s %s %s"),
  lpszDeviceID,
  lpszRequest,
  lpszFlags
);

parameters

lpszDeviceID

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

lpszRequest

用于请求状态信息的标志。 下表列出了可识别 状态 命令的设备类型以及每种类型使用的标志。

设备类型 请求标志
cdaudio
  • cdaudio type track number
  • 当前曲目
  • length
  • length track number
  • media present
  • mode
  • 轨道数
  • position
  • 位置跟踪 号
  • 准备
  • 开始位置
  • 时间格式
digitalvideo
  • 音频
  • 音频对齐方式
  • audio bitspersample
  • 音频中断
  • audio bytespersec
  • 音频输入
  • 音频录制
  • 音频源
  • audio samplespersec
  • 音频流
  • 低音
  • bitsperpel
  • brightness
  • color
  • contrast
  • 当前曲目
  • 磁盘空间 驱动器
  • 文件完成
  • 文件格式
  • 文件模式
  • 转发
  • 已跳过帧
  • gamma
  • input
  • 左卷
  • length
  • length track number
  • media present
  • mode
  • 监视
  • monitor 方法
  • 名义
  • 标称帧速率
  • 名义记录帧速率
  • 轨道数
  • output
  • 调色板句柄
  • 暂停模式
  • 播放速度
  • position
  • 位置跟踪 号
  • 准备
  • 记录帧速率
  • 引用 框架
  • 预留大小
  • 右卷
  • 精确查找
  • 清晰度
  • smpte
  • 速度
  • 开始位置
  • 静态文件格式
  • 时间格式
  • 色调
  • 高音
  • 未保存
  • 视频
  • 视频键索引
  • 视频键颜色
  • 视频录制
  • 视频源
  • 视频源编号
  • 视频流
  • 卷
  • 窗口句柄
  • 窗口可见
  • 窗口最小化
  • 窗口最大化
overlay
  • 媒体显示
  • mode
  • 轨道数
  • 准备
  • Stretch — 拉伸
  • 窗口句柄
sequencer
  • 当前曲目
  • 除法类型
  • length
  • 长度跟踪 数字 主控形状
  • 媒体显示
  • mode
  • 轨道数
  • offset
  • port
  • position
  • 位置跟踪 编号
  • 准备
  • 奴隶
  • 开始位置
  • 节奏
  • 时间格式
录像机
  • 汇编记录
  • 音频监视器
  • 音频监视器编号
  • 音频录制
  • 音频录制曲 目编号
  • 音频源
  • 音频源编号
  • channel
  • 通道调谐器 编号
  • clock
  • 时钟 ID
  • counter
  • 计数器格式
  • 计数器分辨率
  • 当前曲目
  • 帧速率
  • 索引
  • index on
  • length
  • length track number
  • 媒体显示
  • 媒体类型
  • mode
  • 音轨数
  • 轨道数
  • 视频轨道数
  • 暂停 超时
  • 播放格式
  • position
  • 位置开始
  • 位置跟踪 编号
  • postroll 持续时间
  • 开机
  • 预滚动 持续时间
  • 准备
  • 记录格式
  • 速度
  • 时间格式
  • 时间模式
  • 时间类型
  • 时间代码存在
  • timecode 记录
  • timecode 类型
  • tuner 编号
  • 视频监视器
  • 视频监视器编号
  • 视频录制
  • 视频录制跟踪 编号
  • 视频源
  • 视频源编号
  • 写保护
videodisc
  • 当前曲目
  • 光盘大小
  • 转发
  • length
  • length track number
  • 媒体显示
  • 媒体类型
  • mode
  • 轨道数
  • position
  • 位置跟踪 编号
  • 准备
  • 一边
  • 速度
  • 开始位置
  • 时间格式
waveaudio
  • 对齐 (alignment)
  • bitspersample
  • bytespersec
  • channels
  • 当前曲目
  • format 标记
  • input
  • length
  • length track number
  • 级别
  • media present
  • mode
  • 轨道数
  • output
  • position
  • 位置跟踪 号
  • 准备
  • samplespersec
  • 开始位置
  • 时间格式

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

值 含义
对齐 (alignment) 返回数据的块对齐方式（以字节为单位）。
汇编记录 如果设备设置为汇编模式录制，则返回 TRUE 。
音频 返回“on”或“off”，具体取决于最新的 setaudio “on” 或 “off” 命令。 如果任一或两个扬声器都已启用，则返回“on”，否则返回“关闭”。
音频对齐方式 返回数据块相对于输入波形音频数据的开始对齐方式。
audio bitspersample 返回设备用于记录的每个样本的位数。 此标志仅适用于支持“pcm”算法的设备。
音频中断 返回最后一个 AVI 序列的音频部分中断的次数。 每当尝试将音频数据写入设备驱动程序时，系统会对音频中断进行计数，并发现驱动程序已播放所有可用数据。 此标志仅由 MCIAVI 数字视频驱动程序识别。 它仅用于性能评估：返回值难以解释。
audio bytespersec 返回每秒用于记录的平均字节数。
音频输入 返回模拟输入音频信号的近似即时音频级别。 大于 1000 的值表示剪辑失真。 某些设备只能在录制音频时返回此值。 值没有关联的 set 或 setaudio 命令。
音频监视器 返回“output”，或有效的源输入类型之一。 有关详细信息，请参阅 setaudio “monitor”命令。
音频监视器编号 返回 状态 “音频监视器”指定的类型的受监视视频编号。 有关详细信息，请参阅 setaudio 命令。
音频录制 返回“on”或“off”，反映 setaudio “record”设置的状态。
音频录制曲目 编号 如果 VCR 设置为录制音频，则返回 TRUE 。 如果未提供跟踪编号，则假定默认值为 1。
audio samplespersec 返回每秒记录的样本数。
音频源 返回当前音频数字化器源：“left”、“right”、“average”或“stereo”。
音频源编号 返回 状态 “音频源”返回的类型的音频源编号。 有关详细信息，请参阅 setaudio 命令。
音频流 返回当前音频流编号。
低音 返回当前音频低音级别。
bitsperpel 返回用于保存捕获或记录的数据的每像素的位数。
bitspersample 返回每个样本的位数。
brightness 返回当前视频亮度级别。
bytespersec 返回每秒播放或记录的平均字节数。
cdaudio type track number 返回指定曲目编号的类型。 这可以是“音频”或“其他”。
channel 返回在调谐器上设置的通道的整数值。
通道调谐器 编号 如果提供了“tuner” 编号 ，则将返回逻辑优化器 编号 上当前选择的通道。 请注意，可以有多个逻辑优化器。
channels 返回为单声道 (1、立体声) 2 设置的通道数。
clock 返回外部时间。 时间必须是表示总增量的无符号长整数。 有关详细信息，请参阅 功能 “时钟递增率”命令。
时钟 ID 返回标识时钟的唯一整数。
color 返回当前颜色级别。
contrast 返回当前对比度级别。
counter 以当前计数器格式返回计数器位置。
计数器格式 返回当前计数器格式。 有关详细信息，请参阅 set “counter format”命令。
计数器分辨率 返回“frames”或“seconds”，指示计数器的分辨率。 这与准确性不同。
当前曲目 返回当前轨迹。MCISEQ 序列器返回 1。
光盘大小 返回 8 或 12，指示加载的光盘的大小（以英寸为单位）。
磁盘空间 驱动器 以当前时间格式返回可通过指定磁盘驱动器的保留命令获取的近似磁盘空间。驱动器通常指定为单个字母或单个字母，后跟冒号 (：) 。 但是，某些设备可能使用路径。
除法类型 返回以下文件划分类型之一：
  • PPQN
  • SMPTE 24 帧
  • SMPTE 25 帧
  • SMPTE 30 放置帧
  • SMPTE 30 帧

使用此信息来确定 MIDI 文件的格式以及节奏和位置信息的含义。
文件完成 返回 加载、 保存、 捕获、 剪切、 复制、 删除、 粘贴或 撤消 操作的估计百分比。 (应用程序可以使用它来提供进度的可视指示器。)
文件格式 返回 记录 或 保存 命令的当前文件格式。
文件模式 返回“loading”、“saving”、“editing”或“idle”。 在 加载 操作期间，它将返回“load”。 在 保存 和 捕获 操作期间，它将返回“正在保存”。 在 剪切、 复制、 删除、 粘贴或 撤消 操作期间，它将返回“编辑”。
格式标记 返回格式标记。
转发 如果播放方向向前或设备未播放，则返回 TRUE 。
帧速率 返回设备默认使用的每秒帧数。 NTSC 设备返回 30、PAL 25 等。
已跳过帧 返回播放最后一个 AVI 序列时未绘制的帧数。 此标志仅由 MCIAVI 数字视频驱动程序识别。 它仅用于性能评估;返回值难以解释。
gamma 返回使用 setvideo “gamma to” 值设置的值。
索引 返回当前索引显示。 有关详细信息，请参阅 set “index” 命令。
index on 如果索引为打开，则返回 TRUE 。
input 返回输入集。 如果未设置，则返回的错误指示可以使用任何设备。 对于数字视频设备，修改“低音”、“高音”、“音量”、“亮度”、“颜色”、“对比度”、“伽玛”、“锐度”或“淡色”标志，使其仅应用于输入。 这是监视输入时的默认值。
左卷 返回为左侧音频通道设置的音量。
length 以当前时间格式返回媒体的总长度。 对于 PPQN 文件，长度以歌曲指针单位返回。 对于 SMPTE 文件，它将返回为 hh：mm：ss：ff，其中 hh 为小时， mm 为分钟， ss 为秒， ff 为帧。 对于 VCR 设备，长度为 2 小时 (除非已使用 set 命令) 显式更改长度。
length track number 返回由 数字指定的轨迹长度（以时间或帧为单位）。对于 PPQN 文件，长度以歌曲指针单位返回。 对于 SMPTE 文件，它将返回为 hh：mm：ss：ff，其中 hh 为小时， mm 为分钟， ss 为秒， ff 为帧。
级别 返回当前 PCM 音频样本值。
主 根据同步集的类型返回“midi”、“none”或“smpte”。
媒体显示 如果在设备中插入媒体，则返回 TRUE ，否则返回 FALSE 。 Sequencer、video-overlay、digital-video 和 waveform-audio 设备返回 TRUE。
媒体类型 返回媒体的类型。 对于 VCRS，这是“8mm”、“vhs”、“svhs”、“beta”、“Hi8”、“edbeta”或“other”。 对于 videodiscs，这是“CAV”、“CLV”或“其他”，具体取决于 videodisc 的类型。
mode 返回设备的当前模式。 所有设备都可以返回“未就绪”、“已暂停”、“正在播放”和“已停止”值。 某些设备可以返回其他“打开”、“已寄存”、“录制”和“查找”值。
监视 返回“file”或“input”。 返回的值指示当前演示文稿源。
monitor 方法 返回“pre”、“post”或“direct”。 返回的值指示用于输入监视的方法。
名义 该项修改“bass”、“brightness”、“color”、“contrast”、“gamma”、“sharpness”、“tint”、“treble”和“volume”标志，以返回名义值而不是当前设置。
标称帧速率 返回与文件关联的标称帧速率。 单位以每秒帧数乘以 1000。
标称记录帧速率 返回与输入视频信号关联的标称帧速率。 单位以每秒帧数乘以 1000。
音轨数 返回媒体上的音轨数。
轨道数 返回媒体上的曲目数。 与大多数 VCR 设备一样，MCISEQ 和 MCIWAVE 设备返回 1。 MCIPIONR 设备不支持此标志。
视频轨道数 返回媒体上的视频轨道数。
offset 返回基于 SMPTE 的文件的偏移量。 偏移量是基于 SMPTE 的序列的开始时间。 时间返回为 hh：mm：ss：ff，其中 hh 为小时， mm 为分钟， ss 为秒， ff 为帧。
output 返回当前设置的输出。 如果未设置输出，则返回的错误指示可以使用任何设备。 对于数字视频设备，修改“低音”、“高音”、“音量”、“亮度”、“颜色”、“对比度”、“伽玛”、“锐度”或“淡色”标志，使其仅应用于输出。 这是监视文件时的默认值。
暂停模式 如果设备在录制时暂停，则返回“录制”。 如果设备在播放时暂停，它将返回“正在播放”。 如果未暂停设备，则返回错误“操作不适用于当前模式”。
暂停超时 返回 暂停 命令的最大持续时间（以毫秒为单位）。
播放格式 返回一个代码，指示将播放录像带的格式（如果可检测到）：“lp”、“ep”、“sp”或“other”。 有关详细信息，请参阅“记录格式”标志。
播放速度 返回一个值，该值表示最后一个 AVI 序列的实际播放时间与目标播放时间的匹配程度。 值 1000 指示目标时间和实际时间相同。 例如，如果值为 2000，则表示 AVI 序列的播放时间是该序列的两倍。 此标志仅由 MCIAVI 数字视频驱动程序识别。 它仅用于性能评估;返回值难以解释。
port 返回分配给序列的 MIDI 端口号。
position 返回当前位置。对于 PPQN 文件，以歌曲指针单位返回位置。 对于 SMPTE 文件，它将返回为 hh：mm：ss：ff，其中 hh 为小时， mm 为分钟，ss 为秒， ff 为帧。
位置开始 返回可用媒体的起始位置。
位置跟踪 编号 返回 由 number 指定的轨道的起点位置。 对于 PPQN 文件，时间格式以歌曲指针单位返回。 对于 SMPTE 文件，它将返回为 hh：mm：ss：ff，其中 hh 为小时， mm 为分钟， ss 为秒， ff 为帧。 MCISEQ 排序器返回零。 MCIPIONR 设备不支持此标志。 MCIWAVE 设备返回零。
postroll 持续时间 返回发出 停止 或 暂停 命令时刹车 VCR 传输所需的当前时间格式的录像带长度。
开机 如果 VCR 的电源已打开，则返回 TRUE 。
预滚动持续时间 返回稳定 VCR 输出所需的当前时间格式的录像带长度。
准备 如果设备已准备好接受另一个命令，则返回 TRUE 。
记录格式 返回一个代码，指示将录制录像带的格式。 当前返回类型为“lp”、“ep”、“sp”或“other”。 这些格式不特定于 VHS，可以应用于具有多种可选录制格式的任何 VCR。 “sp”类型是最快、质量最高的录制格式，在单格式 VCR 上用作默认格式。
记录帧速率 返回用于压缩的帧速率（以帧/秒乘以 1000）。
参考 框架 返回指定帧之前的最近关键帧图像的 帧编号。
保留大小 以当前时间格式返回保留工作区的大小。 大小对应于从完整工作区播放压缩数据所花费的大致时间。 如果没有保留的磁盘空间，则返回零。 此标志返回近似大小，因为一般情况下，在压缩数据之后，无法预测压缩数据的精确磁盘空间。
右音量 返回为正确的音频声道设置的音量。
samplespersec 返回每秒播放或录制的样本数。
精确查找 返回“on”或“off”，指示是否设置了“精确查找”标志。
清晰度 返回设备的当前锐度级别。
一边 返回 1 或 2，指示加载视频磁盘的哪一侧。
奴隶 根据同步集的类型返回“file”、“midi”、“none”或“smpte”。
smpte 返回与工作区中当前位置关联的 SMPTE 时间代码。 这是一个格式为 dd：dd：dd：dd 的字符串，其中每个 d 表示一个介于 0 到 9 之间的数字。 如果工作区数据不包括时间代码数据，则此标志返回 00：00：00：00： 00。
速度 返回设备的当前速度（以帧/秒 (或 设置 的“速度”命令) 使用的相同格式）。 MCIPIONR videodisc 播放器不支持此标志。
开始位置 返回媒体的起始位置。
静态文件格式 返回 捕获 命令的当前文件格式。
Stretch — 拉伸 如果启用拉伸，则返回 TRUE 。
节奏 以当前时间格式返回 MIDI 序列的当前节奏。 对于 PPQN 格式的文件，节奏为每分钟节拍数。 对于 SMPTE 格式的文件，节奏以帧/秒为单位。
时间格式 返回当前时间格式。 有关详细信息，请参阅 set 命令中的时间格式。
时间模式 返回当前位置时间模式。 它可以是“detect”、“timecode”或“counter”。
时间类型 返回正在使用的当前位置时间：“timecode”或“counter”。
时间代码存在 如果在磁带上的当前位置记录了时间码，则返回 TRUE 。 时间代码必须从当前位置前进。 可能需要播放 VCR 才能检查这种情况。
timecode 记录 如果 VCR 设置为记录时间码，则返回 TRUE 。
timecode 类型 返回“smpte”、“smpte drop”、“other”或“none”。 请注意，每秒帧数可以从状态“帧速率”命令获取，设备的准确性可以通过 功能 “查找准确性”命令返回。
色调 返回当前视频色调级别。
高音 返回当前音频高音级别。
tuner 编号 返回当前逻辑优化器编号。
未保存 如果工作区中记录的数据可能因关闭、加载、记录、保留、剪切、删除或粘贴命令而丢失，则返回 TRUE。 否则返回 FALSE 。
视频 返回“on”或“off”，反映 setvideo 命令设置的状态。
视频键颜色 返回键颜色的值。
视频键索引 返回键索引的值。
视频监视器 返回“output”或有效的源输入类型之一。 有关详细信息，请参阅 setvideo “monitor”命令。
视频监视器编号 返回状态“视频监视器”返回的类型的受监视视频编号。 有关详细信息，请参阅 setvideo 命令。
视频录制 返回“on”或“off”，反映 setvideo “record”设置的当前状态。
视频记录跟踪 号 如果 VCR 设置为录制视频，则返回 TRUE 。 如果未提供跟踪编号，则假定默认值为 1。
视频源 返回视频源类型。 有关详细信息，请参阅 setvideo 命令。
视频源编号 返回一个数字，该数字对应于正在使用的类型的视频源。 例如，如果使用第二个 NTSC 视频源输入，则返回 2。
视频流 返回当前视频流编号。
卷 返回左右扬声器的平均音量。 如果设备尚未播放或音量尚未设置，则返回错误。
窗口句柄 返回返回值低序字中的窗口句柄的 ASCII 十进制值。
窗口最大化 如果窗口最大化，则返回 TRUE 。
窗口最小化 如果窗口最小化，则返回 TRUE 。
窗口可见 如果未隐藏窗口，则返回 TRUE 。
write protected 如果设备检测到它无法记录 (，则返回 TRUE ，即，如果写入保护处于) 。 如果它可以记录，或者无法确定它是否可以记录 (而不实际写入) ，驱动程序将返回 FALSE。

lpszFlags

可以是“等待”、“通知”或两者。 对于数字视频和 VCR 设备，还可以指定“测试”。 有关这些标志的详细信息，请参阅 等待、通知和测试标志。

返回值

返回 mciSendString 的 lpszReturnString 参数中的信息。 信息取决于请求类型。

备注

在发出任何使用位置值的命令之前，应使用 set 命令设置所需的时间格式。

示例

以下命令返回“mysound”设备的当前模式。

status mysound mode

要求

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

请参阅

Mci

MCI 命令字符串

capability

捕获

close

削减

delete

加载

pause

粘贴

record

保留

保存

set

setaudio

setvideo

stop

撤消