list 命令

list 命令确定视频和音频输入的数量和类型。 数字视频和 VCR 设备可识别此命令。

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

_stprintf_s(
  lpszCommand, 
  TEXT("list %s %s %s"), 
  lpszDeviceID, 
  lpszList, 
  lpszFlags
); 

parameters

lpszDeviceID

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

lpszList

标识视频和音频输入的数量和类型的标志。 下表列出了可识别 list 命令的设备类型以及每种类型使用的标志。

值	含义	含义
digitalvideo	音频算法音频 质量算法音频流countnumber index	still algorithmstill quality algorithm algorithmvideo algorithmvideo quality algorithm algorithmvideo sourcevideo stream
录像机	音频源 countaudio 源编号 索引	视频源计数视频源编号 索引

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

“值”	含义
音频算法	指定命令应检索音频算法名称。
音频 质量算法	指定命令应检索与指定 算法关联的质量级别。 如果 算法 为“current”，则返回当前算法的质量级别。
音频源计数	返回音频输入的总数。
音频源编号 索引	返回源 索引的音频输入的类型。
音频流	指定命令应检索与工作区关联的音频流的名称。 这些字符串 (（如“英语”或“德语”) ）嵌入到 文件中，并标识流。
count	返回指定类型的选项数。
数字 索引	返回一个字符串，该字符串描述由指定选项类型的 索引) 标识的特定选项 (。 Index 必须是介于 1 和“count”返回的值之间的整数。
静态算法	指定命令应检索静态算法名称。
静态 质量算法	指定命令应检索与指定静态 算法关联的质量级别。 如果 算法 为“current”，则返回当前算法的质量级别。
视频算法	指定命令应检索视频算法名称。
视频 质量算法	指定命令应检索与指定视频 算法关联的质量级别。 如果 算法 为“current”，则返回当前算法的质量级别。
视频源	指定命令应返回有关视频源的信息。 与“count”标志一起使用时，它将返回视频源的数量。 与“数字”标志一起使用时，它将返回视频源的类型。 MCI 为类型定义以下常量：“ntsc”、“rgb”、“pal”、“secam”、“svideo”和“generic”。 返回的每种类型可能有多个源。 当该连接器允许多个信号时，将使用“泛型”源类型。
视频源计数	返回视频输入的总数。
视频源编号 索引	返回源 索引的视频输入的类型。
视频流	指定命令应检索与工作区关联的视频流的名称。 这些字符串 (如“有趣的结尾”或“悲伤结局”) 嵌入到文件中并标识流。

lpszFlags

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

返回值

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

备注

对于 VCR 设备，必须使用“count”或“number”标志指定“视频源”或“音频源”。 如果指定了“count”，则返回视频或音频的输入总数。 如果指定了“number”，驱动程序将返回与输入对应的类型。 类型可以是以下任一类型：“tuner”、“line”、“svideo”、“aux”或“generic”。 通常，应首先在 VCR 中查询“count”，然后使用计数作为“number”标志的范围。 “源”数字从 1 开始。

要求

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

请参阅

Mci

MCI 命令字符串