MCI_SYSINFO
The MCI_SYSINFO
command retrieves information about MCI devices. MCI supports this command
directly rather than passing it to the device. Any MCI application can use this
command. String information is returned in the application-supplied buffer
pointed to by the lpstrReturn member of the structure identified by lpSysInfo.
Numeric information is returned as a doubleword value placed in the
application-supplied buffer. The dwRetSize member specifies the buffer
length.
MCIERROR mciSendCommand(MCIDEVICEID wDeviceID,
MCI_SYSINFO,
DWORD dwFlags, (DWORD)
(LPMCI_SYSINFO_PARMS) lpSysInfo);
Parameters
wDeviceID
Device
identifier of the MCI device that is to receive the command message.
dwFlags
One or more
of the following standard and command-specific flags:
MCI_SYSINFO_INSTALLNAME
Obtains the
name (listed in the registry or the SYSTEM.INI file) used to install the
device.
MCI_SYSINFO_NAME
Obtains a
device name corresponding to the device number specified in the dwNumber
member of the structure identified by lpSysInfo. If the MCI_SYSINFO_OPEN
flag is set, MCI returns the names of open devices.
MCI_SYSINFO_OPEN
Obtains the
quantity or name of open devices.
MCI_SYSINFO_QUANTITY
Obtains the
number of devices of the specified type that are listed in the registry or the
[mci] section of the SYSTEM.INI file. If the MCI_SYSINFO_OPEN flag is set, the
number of open devices is returned.
lpSysInfo
Address of an
MCI_SYSINFO_PARMS
structure.
Return Values
Returns zero
if successful or an error otherwise.
Remarks
The wDeviceType
member of the structure identified by lpSysInfo is used to indicate the
device type of the query. If the wDeviceID parameter is set to
MCI_ALL_DEVICE_ID, it overrides the value of wDeviceType. For a list of
device types, see Constants: Device Types.
Integer
return values are doubleword values returned in the buffer pointed to by the lpstrReturn
member of the structure identified by lpSysInfo.
String return
values are null-terminated strings returned in the buffer pointed to by the lpstrReturn
member of the structure identified by lpSysInfo.
See Also