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 [仅限桌面应用] |
标头 |
|