Important Notice

The pages on this site contain documentation for very old MS-DOS software, purely for historical purposes. If you're looking for up-to-date documentation, particularly for programming, you should not rely on the information found here, as it will be woefully out of date.

                                                 ◄Contents► ◄Index► ◄Back►
────────────────────────────────────────────────────────────────────────────
MCI_SYSINFO
 
        This MCI command message returns information about MCI devices.
        MCI supports this message directly rather than passing it to the
        devices. String information is returned in the
        application-supplied buffer pointed to by the lpstrReturn field
        of the data structure identified by lpSysInfo. Numeric
        information is returned as a DWORD placed in the
        application-supplied buffer. The dwRetSize field specifies the
        buffer length.
 
Parameters
        DWORD dwFlags
            The following standard and command-specific flags apply to
            all devices:
 
            MCI_SYSINFO_INSTALLNAME
                Obtains the name (listed in 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 field of the data 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 [mci] section of the SYSTEM.INI file.
                If the MCI_SYSINFO_OPEN flag is set, the number of open
                devices is returned.
 
        LPMCI_SYSINFO_PARMS lpSysInfo
            Specifies a far pointer to the MCI_SYSINFO_PARMS structure.
 
Return value
        Returns zero if successful. Otherwise, it returns an MCI error
        code.
 
Comments
        The wDeviceType field of the lpSysInfo structure indicates the
        device type of the query. If the wDeviceID parameter is set to
        MCI_ALL_DEVICE_ID, it overrides the value of the wDeviceType
        field.
 
        Integer return values are DWORDS returned in the buffer pointed
        to by the lpstrReturn field of MCI_SYSINFO_PARMS.
 
        String return values are NULL-terminated strings returned in the
        buffer pointed to by the lpstrReturn field.
 
                                       -♦-