info 命令

info 命令从设备检索硬件说明。 所有 MCI 设备都可以识别此命令。

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

_stprintf_s(
  lpszCommand, 
  TEXT("info %s %s %s"), 
  lpszDeviceID, 
  lpszInfoType, 
  lpszFlags
); 

parameters

lpszDeviceID

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

lpszInfoType

标识所需信息类型的标志。 下表列出了可识别 info 命令的设备类型以及每种类型使用的标志。

“值”	含义	含义
cdaudio	info identityinfo	product
digitalvideo	audio algorithmaudio qualityfileproductstill algorithmstill quality	usageversionvideo 算法视频质量窗口文本
overlay	fileproduct	窗口文本
sequencer	copyrightfile	nameproduct
录像机	product	版本
videodisk	product
waveaudio	fileinput	outputproduct

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

“值”	含义
音频算法	返回当前音频压缩算法的名称。
音频质量	返回当前音频质量描述符的名称。 如果应用程序将参数设置为与定义的质量不相对应的特定值，则可能会返回“未知”。
copyright	从版权元事件中检索 MIDI 文件版权声明。
文件	检索复合设备使用的文件的名称。 如果打开设备时没有文件，并且尚未使用 load 命令，则返回 null 字符串。
信息标识	为正在查询的播放器中当前加载的音频 CD 生成唯一标识符。
info（info）（info）（	在音频 CD 上编码 (生成通用产品代码) 。 该单位为数字字符串。 它可能不适用于所有 CD。
input	检索当前输入设备的说明。 如果未设置输入设备，则返回“none”。
name	从序列/跟踪名称元事件中检索序列名称。
output	检索当前输出设备的说明。 如果未设置输出设备，则返回“none”。
product	检索设备的说明。 此信息通常包括产品名称和型号。 字符串长度为 31 个字符或更少。
静态算法	返回当前静止图像压缩算法的名称。
仍然质量	返回当前静止图像质量描述符的名称。 如果应用程序将参数设置为与定义的质量不相对应的特定值，则可能会返回“未知”。
usage	返回一个字符串，描述工作区中视觉或音频数据的所有者可能施加的使用限制。
版本	返回设备驱动程序和硬件的发布级别。
视频算法	返回当前视频压缩算法的名称。
视频质量	返回当前视频质量描述符的名称。 如果应用程序将参数设置为与定义的质量不相对应的特定值，则可能会返回“未知”。
窗口文本	检索设备使用的窗口的描述文字。

lpszFlags

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

返回值

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

示例

以下命令检索与“mysound”设备关联的硬件的说明。

info mysound product

要求

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

另请参阅

Mci

MCI 命令字符串

加载