MCI_SYSINFO 命令

  • 项目

MCI_SYSINFO 命令检索有关 MCI 设备的信息。 MCI 直接支持此命令，而不是将其传递给设备。 任何 MCI 应用程序都可以使用此命令。 字符串信息在由 lpSysInfo 标识的 结构的 lpstrReturn 成员指向的应用程序提供的缓冲区中返回。 数值信息作为放置在应用程序提供的缓冲区中的 DWORD 值返回。 dwRetSize 成员指定缓冲区长度。

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

MCIERROR mciSendCommand(
  MCIDEVICEID wDeviceID, 
  MCI_SYSINFO, 
  DWORD dwFlags, 
  (DWORD) (LPMCI_SYSINFO_PARMS) lpSysInfo
);

parameters

wDeviceID

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

dwFlags

以下一个或多个特定于标准和命令的标志：

MCI_SYSINFO_INSTALLNAME

获取注册表中列出的名称 (或用于安装设备的SYSTEM.INI文件) 。

MCI_SYSINFO_NAME

获取与lpSysInfo 标识的结构的 dwNumber 成员中指定的设备编号对应的设备名称。 如果设置了MCI_SYSINFO_OPEN标志，MCI 将返回打开的设备的名称。

MCI_SYSINFO_OPEN

获取打开设备的数量或名称。

MCI_SYSINFO_QUANTITY

获取注册表或 SYSTEM.INI 文件的 [mci] 节中列出的指定类型的设备数。 如果设置了MCI_SYSINFO_OPEN标志，则返回打开的设备数。

lpSysInfo

指向 MCI_SYSINFO_PARMS 结构的指针。

返回值

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

备注

lpSysInfo 标识的 结构的 wDeviceType 成员用于指示查询的设备类型。 如果 wDeviceID 参数设置为 MCI_ALL_DEVICE_ID，它将替代 wDeviceType 的值。 有关设备类型的列表，请参阅 MCI 设备类型。

整数返回值是由 lpSysInfo 标识的结构的 lpstrReturn 成员指向的缓冲区中返回的 DWORD 值。

字符串返回值是由 lpSysInfo 标识的结构的 lpstrReturn 成员指向的缓冲区中返回的以 null 结尾的字符串。

要求

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

另请参阅

Mci

MCI 命令