MCI_SYSINFO - Description

This message returns information about media control devices and device instances.

ulParam1 (ULONG)

This parameter can contain any of the following flags. If the size of the buffer passed in is too small to hold all the data returned, then the ulRetSize field of the MCI_SYSINFO_PARMS data structure will contain the required buffer size, MCIERR_INVALID_BUFFER will be returned, and the buffer will contain only as much of the SYSINFO data as its size permits. Only one MCI_SYSINFO_xxxxx flag can be used per MCI_SYSINFO message. The MCI_SYSINFO_NAME and MCI_SYSINFO_QUANTITY flags are mutually exclusive.

MCI_WAIT

Control is not to be returned until the action indicated by this message is completed or an error occurs.
MCI_SYSINFO_INSTALLNAME
This flag returns the name used to install the device.
MCI_SYSINFO_QUANTITY
This flag sets the media to return the number of devices of the given type. If the MCI_SYSINFO_OPEN flag is set, the number of open devices is returned.
MCI_SYSINFO_NAME
This flag is used to select a number or device ordinal parameter. The media returns the name(s) of a device that satisfies the query. If more than one name is returned then the names are separated by a single blank and the string is null terminated.
MCI_SYSINFO_OPEN
This flag returns the number or name of open devices.
MCI_SYSINFO_ITEM
This flag indicates that the ulItem field contains a constant that indicates the desired MCI_SYSINFO action as indicated by one of the following values:

MCI_SYSINFO_INSTALL_DRIVER

This message creates or updates a logical device entry in the INI file. The pSysInfoParm field points to the MCI_SYSINFO_LOGDEVICE data structure. The driver becomes active the next time the system is started.
MCI_SYSINFO_QUERY_DRIVER
This message queries the information for the driver indicated in the szInstallName field of the MCI_SYSINFO_LOGDEVICE data structure. The pSysInfoParm field points to the MCI_SYSINFO_LOGDEVICE data structure.
MCI_SYSINFO_INI_LOCK
Writes out and then locks the MMPM2.INI file from updates.
MCI_SYSINFO_DELETE_DRIVER
This message removes the specified driver from the INI file. The pSysInfoParm field points to the installation name.
MCI_SYSINFO_SET_PARAMS
This message sets the device-specific parameters for a particular device. Device-specific parameters should be printable ASCII characters only so that response files can be supported. The pSysInfoParm field points to the MCI_SYSINFO_DEVPARAMS data structure.
MCI_SYSINFO_QUERY_PARAMS
This message retrieves the device-specific parameters for a particular device. The pSysInfoParm field points to the MCI_SYSINFO_DEVPARAMS data structure.
MCI_SYSINFO_SET_CONNECTORS
This message sets the logical connector information for a particular device. The connector array defined by ConnectorList (in the MCI_SYSINFO_CONPARAMS data structure) is a list of the connectors in sequential order. For example, ConnectorList[0] is connector index 1. The pSysInfoParm field points to the MCI_SYSINFO_CONPARAMS data structure.
MCI_SYSINFO_QUERY_CONNECTORS
This message retrieves the device connector information for a particular device. The pSysInfoParm field points to the MCI_SYSINFO_CONPARAMS data structure.
MCI_SYSINFO_SET_EXTENSIONS
This message sets the file extension associated with a particular device. The pSysInfoParm field points to the MCI_SYSINFO_EXTENSION data structure. Extensions are unique across installation names. That is, no two installation names can have the same extension.
MCI_SYSINFO_QUERY_EXTENSIONS
This message queries the file extensions associated with a particular device. The pSysInfoParm field points to the MCI_SYSINFO_EXTENSION data structure.
MCI_SYSINFO_SET_TYPES
This message sets the extended type attribute associated with a particular device. The pSysInfoParm field points to the MCI_SYSINFO_TYPES data structure.
MCI_SYSINFO_QUERY_TYPES
This message queries query the extended type attributes associated with a particular device. The pSysInfoParm field points to the MCI_SYSINFO_TYPES data structure.
MCI_SYSINFO_SET_ALIAS
This message associates an alias to a particular device. The pSysInfoParm field points to the MCI_SYSINFO_ALIAS data structure.
MCI_SYSINFO_QUERY_NAMES
This message queries the names associated with a particular device. This message will accept any of the three types of names or device type and device ordinal and fill in the remaining structure if possible. If the device type is given and 0 for the device ordinal then the first device of that type is returned. Only one non-null name or 0 in device type field on input is allowed. The pSysInfoParm field points to the MCI_SYSINFO_QUERY_NAME data structure.
MCI_SYSINFO_SET_DEFAULT
This message sets a device as the default for its device type. If another device is already the default for this device type, then it will be superseded by the new device. The pSysInfoParm field points to the MCI_SYSINFO_DEFAULTDEVICE data structure.
MCI_SYSINFO_QUERY_DEFAULT
This message queries the default device for a given device type. If no explicit default exists, then the first device of the indicated type is implicitly the default. The pSysInfoParm field points to the MCI_SYSINFO_DEFAULTDEVICE data structure.

pParam2 (PMCI_SYSINFO_PARMS)

A pointer to the MCI_SYSINFO_PARMS structure.

rc (ULONG)

Return codes indicating success or type of failure:

MCIERR_SUCCESS

If the function succeeds, 0 is returned.
MCIERR_MISSING_FLAG
A required flag is missing.
MCIERR_UNSUPPORTED_FLAG
Given flag is unsupported for this device.
MCIERR_INVALID_CALLBACK_HANDLE
Given callback handle is invalid.
MCIERR_INVALID_FLAG
Flag (ulParam1) is invalid.
MCIERR_FLAGS_NOT_COMPATIBLE
Flags cannot be used together.
MCIERR_MISSING_PARAMETER
Required parameter is missing.
MCIERR_INVALID_BUFFER
Invalid return buffer given.
MCIERR_DUPLICATE_ALIAS
Alias already exists.
MCIERR_DUPLICATE_EXTENSION
Extension already exists.
MCIERR_NODEFAULT_DEVICE
No device of this type exists.
MCIERR_DEVICE_NOT_FOUND
Device not found for this query.
MCIERR_DUPLICATE_EA
The given EA already exists for another device.

---

[Back: MCI_SYSINFO Return Value - rc]
[Next: MCI_SYSINFO - Remarks]