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.

        [Back] [Next]