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.

QuickInfo

  Windows NT: Requires version 3.1 or later.
  Windows: Requires Windows 95 or later.
  Windows CE: Unsupported.
  Header: Declared in mmsystem.h.

See Also

MCI Overview, MCI Commands, MCI_SYSINFO_PARMS