MCI_INFO 命令

MCI_INFO 命令从设备检索字符串信息。所有设备都可以识别此命令。信息在 lpInfo 标识的结构的 lpstrReturn 成员中返回。 dwRetSize 成员指定返回数据的缓冲区长度。

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

MCIERROR mciSendCommand(
  MCIDEVICEID wDeviceID, 
  MCI_INFO, 
  DWORD dwFlags, 
  (DWORD) (LPMCI_INFO_PARMS) lpInfo
);

parameters

wDeviceID: 要接收命令消息的 MCI 设备的设备标识符。
dwFlags: MCI_NOTIFY、MCI_WAIT，或者，对于数字视频和 VCR 设备，MCI_TEST。有关这些标志的信息，请参阅等待、通知和测试标志。
lpInfo: 指向 MCI_INFO_PARMS 结构的指针。具有扩展命令集 (设备可能会将此结构替换为特定于设备的结构。)

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

以下附加标准和特定于命令的标志适用于支持MCI_INFO的所有设备：

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

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

MCI_DGV_INFO_ITEM: 一个常量，指示所需信息包含在由 lpInfo 标识的结构的 dwItem 成员中。为数字视频设备定义了以下常量：
MCI_DGV_INFO_AUDIO_ALG: 返回当前音频压缩算法的名称。
MCI_DGV_INFO_AUDIO_QUALITY: 返回当前音频质量描述符的名称。
MCI_DGV_INFO_STILL_ALG: 返回当前静止图像压缩算法的名称。
MCI_DGV_INFO_STILL_QUALITY: 返回当前静止图像质量描述符的名称。
MCI_DGV_INFO_USAGE: 返回一个字符串，描述工作区中可视或有声数据的所有者可能施加的使用限制。
MCI_DGV_INFO_VIDEO_ALG: 返回当前视频压缩算法的名称。
MCI_DGV_INFO_VIDEO_QUALITY: 返回当前视频质量描述符的名称。
MCI_INFO_VERSION: 返回设备驱动程序和硬件的发布级别。设备驱动程序开发人员必须记录返回的字符串的语法。
MCI_DGV_INFO_TEXT: 获取窗口描述文字。
MCI_INFO_FILE: 获取使用 MCI_OPEN 或 MCI_LOAD 命令指定的最后一个文件的路径和文件名。如果未指定文件，设备将返回以 null 结尾的字符串。只有将 TRUE 返回到 MCI_GETDEVCAPS 命令的MCI_GETDEVCAPS_USES_FILES标志的设备才支持此标志。

对于数字视频设备， lpInfo 指向 MCI_DGV_INFO_PARMS 结构。

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

MCI_INFO_COPYRIGHT: 从版权元事件获取 MIDI 文件版权声明。
MCI_INFO_FILE: 获取当前文件的文件名。当你使用 MCI_GETDEVCAPS_USES_FILES 标志调用 MCI_GETDEVCAPS 命令时，只有返回 TRUE 的设备才支持此标志。
MCI_INFO_NAME: 从序列/跟踪名称元事件中获取序列名称。

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

MCI_VCR_INFO_VERSION: 将 MCI_INFO_PARMS 结构的 lpstrReturn 成员设置为指向版本号。此外，将 dwRetSize 成员设置为等于指向的字符串的长度。

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

MCI_INFO_FILE: 获取当前文件的文件名。只有将 TRUE 返回到 MCI_GETDEVCAPS 命令的MCI_GETDEVCAPS_USES_FILES标志的设备才支持此标志。
MCI_OVLY_INFO_TEXT: 获取与视频覆盖设备关联的窗口的描述文字。

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

MCI_INFO_FILE: 获取当前文件的文件名。使用 MCI_GETDEVCAPS_USES_FILES 标志调用 MCI_GETDEVCAPS 命令时，返回 TRUE 的设备支持此标志。
MCI_WAVE_INPUT: 获取当前输入的产品名称。
MCI_WAVE_OUTPUT: 获取当前输出的产品名称，其值特定于设备。

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