MCI_SYSINFO command

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 DWORD value placed in the application-supplied buffer. The dwRetSize member specifies the buffer length.

To send this command, call the mciSendCommand function with the following parameters.

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 bylpSysInfo. 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

Pointer to an MCI_SYSINFO_PARMS structure.

Return Value

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 MCI Device Types.

Integer return values are DWORD 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.

Requirements

Requirement Value
Minimum supported client
Windows 2000 Professional [desktop apps only]
Minimum supported server
Windows 2000 Server [desktop apps only]
Header
Mmsystem.h (include Windows.h)

See also

MCI

MCI Commands