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.