MCI_LIST 命令

  • 项目

MCI_LIST 命令获取有关可供设备使用的输入数量和类型的信息。 数字视频和 VCR 设备可识别此命令。

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

MCIERROR mciSendCommand(
  MCIDEVICEID wDeviceID, 
  MCI_LIST, 
  DWORD dwFlags, 
  (DWORD) (LPMCI_GENERIC_PARMS) lpList
);

参数

wDeviceID

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

dwFlags

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

lpList

指向 MCI_GENERIC_PARMS 结构的指针。 （具有扩展命令集的设备可能会用设备特定的结构替换此结构。）

返回值

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

备注

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

MCI_DGV_LIST_ALG

由 lpList 标识的结构的 lpstrAlgorithm 成员包含缓冲区的地址，其中包含算法名称。 该名称用于检索与算法关联的质量描述符的类型。

MCI_DGV_LIST_COUNT

返回指定类型的选项数。

MCI_DGV_LIST_ITEM

指示列表类型的常量包含在由 lpList 标识的结构的 dwItem 成员中。 需要此标记。 使用以下常量之一来指示列表类型：

MCI_DGV_LIST_AUDIO_ALG

此命令应会检索音频算法的名称。

MCI_DGV_LIST_AUDIO_QUALITY

此命令应会检索音频质量级别。 返回的级别与 lpList 标识的结构的 lpstrAlgorithm 成员引用的算法相关联。 如果使用字符串“current”指定该成员，则返回与当前算法关联的质量。

MCI_DGV_LIST_AUDIO_STREAM

此命令应会检索音频流的名称。

MCI_DGV_LIST_STILL_AL

此命令应会检索静止算法的名称。

MCI_DGV_LIST_STILL_QUALITY

此命令应会检索质量级别。 返回的级别与 lpList 标识的结构的 lpstrAlgorithm 成员引用的算法相关联。 如果使用字符串“current”指定该成员，则返回与当前算法关联的质量。

MCI_DGV_LIST_VIDEO_ALG

此命令应会检索视频算法的名称。

MCI_DGV_LIST_VIDEO_QUALITY

此命令应会检索视频质量级别。 返回的级别与 lpList 标识的结构的 lpstrAlgorithm 成员引用的算法相关联。 如果使用字符串“current”指定该成员，则返回与当前算法关联的质量。

MCI_DGV_LIST_VIDEO_SOURCE

此命令应会返回有关视频源的信息。 与 MCI_DGV_LIST_COUNT 一起使用时，此命令返回视频源的数量。 与 MCI_DGV_LIST_NUMBER 一起使用时，此命令返回视频源的类型。 MCI 定义了以下类型：

  • MCI_DGV_SETVIDEO_SRC_GENERIC
  • MCI_DGV_SETVIDEO_SRC_NTSC
  • MCI_DGV_SETVIDEO_SRC_PAL
  • MCI_DGV_SETVIDEO_SRC_RGB
  • MCI_DGV_SETVIDEO_SRC_SECAM
  • MCI_DGV_SETVIDEO_SRC_SVIDEO

返回的每种类型可能有多个源。 当该连接器允许使用多种类型的信号时，将使用通用源类型。

MCI_DGV_LIST_VIDEO_STREAM

此命令应会检索视频流的名称。

MCI_DGV_LIST_NUMBER

索引在由 lpList 标识的结构的 dwNumber 成员中指定。 该索引必须是一个介于 1 和为 MCI_DGV_LIST_COUNT 标志返回的值之间的整数。

对于数字视频设备，lpList 指向 MCI_DGV_LIST_PARMS 结构。

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

MCI_VCR_LIST_AUDIO_SOURCE

列出音频输入或类型。

MCI_VCR_LIST_COUNT

将 lpList 所标识的结构的 dwReturn 成员设置为视频或音频输入的总数。

MCI_VCR_LIST_NUMBER

将 lpList 所标识的结构的 dwReturn 成员设置为 dwNumber 成员指定的视频或音频输入的类型。

MCI_VCR_LIST_VIDEO_SOURCE

列出视频输入或类型。

对于 VCR 设备，lpList 指向 MCI_VCR_LIST_PARMS 结构。

要求

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

另请参阅

MCI

MCI 命令