ulParam1 (ULONG)

      This parameter can contain the following flags:

      MCI_NOTIFY

        A notification message will be posted to the window specified in the hwndCallback parameter of the data structure pointed to by the pParam2 parameter. The notification will be posted when the action indicated by this message is completed or when an error occurs.
      MCI_WAIT
        Control is not to be returned until the action indicated by this message is completed or an error occurs.
      MCI_SET_AUDIO
        Sets audio attributes of the device instance. A device with audio capabilities might support both left and right channels. The channel is specified in the ulAudio field of the data structure specified by pParam2. The action to be taken is specified with the flags MCI_SET_ON (which enables audio output at the current volume level), MCI_SET_OFF (which mutes audio output), or MCI_SET_VOLUME. Specifying MCI_SET_VOLUME does not enable audio output if MCI_SET_OFF has been previously specified.

        The following constants are defined for specifying the audio channel in the ulAudio field.

        MCI_SET_AUDIO_ALL

          Apply to both channels.
        MCI_SET_AUDIO_LEFT
          Apply to the left channel only.
        MCI_SET_AUDIO_RIGHT
          Apply to the right channel only.
        MCI_SET_DOOR_OPEN
          Instructs the device to open the media cover (if any). This message ejects the media from devices where appropriate.
        MCI_SET_DOOR_CLOSED
          Instructs the device to close the media cover (if any).
        MCI_SET_DOOR_LOCK
          Locks the media cover on the device (if any). This disables manual ejection of the media from the device.
        MCI_SET_DOOR_UNLOCK
          Unlocks the media cover on the device (if any). This enables manual ejection of the media from the device.
        MCI_SET_VOLUME
          Sets the level of audio as a percentage of the maximum audio level as indicated in the ulLevel field. The volume level that can be set on the device might be of coarser granularity than that specified. In this case, the actual level can be obtained by issuing a MCI_STATUS message. If a number greater than 100 is given, then 100 will be used as the volume setting, and no error will be returned. See Examples section for an example using this flag.
        MCI_SET_VIDEO
          Sets the video signal on or off. This flag must be used with either MCI_SET_ON or MCI_SET_OFF.
        MCI_SET_ON
          Sets the video or specified audio channel on.
        MCI_SET_OFF
          Sets the video or specified audio channel off.
        MCI_SET_SPEED_FORMAT
          Specifies the speed format to be used on subsequent commands contained in the ulSpeedFormat field. The following values can be used:

          MCI_FORMAT_PERCENTAGE

            Specifies the subsequent speed values as a percentage of the normal speed.
          MCI_FORMAT_FPS
            Specifies the subsequent speed values in frames per second. This is the default setting.
          MCI_SET_TIME_FORMAT
            Uses a time format on subsequent commands. A time-format parameter must be indicated in the ulTimeFormat field of the data structure specified by pParam2 if this flag is used. The default is MCI_FORMAT_MMTIME. The following time formats are generic; devices can also provide device-specific time units:

            MCI_FORMAT_MILLISECONDS

              Indicates that all subsequent commands that specify time will do so in milliseconds for both input and output.
            MCI_FORMAT_MMTIME
              Indicates that all subsequent commands that specify time will do so in MMTIME units for both input and output. This does not apply to command parameters that explicitly specify time units, such as milliseconds on ulOver.
            MCI_OVER
              Sets the vectored delay time to change the volume (or other attribute) in milliseconds.
            MCI_SET_ITEM
              Indicates that the item to be set is specified in the ulItem field of the data structure identified by pParam2. Any value associated with the item is contained in the ulValue field. Each item defines the use (if any) and meaning of the value in the ulValue field.
            Amplifier Mixer Extensions

            The following additional flags apply to amplifier-mixer devices. Only one audio attribute set function can be performed at a time with the MCI_SET message. The treble, bass, balance, pitch, and gain flags require the MCI_SET_AUDIO flag also to be set. The level to be set for each function is contained in the ulLevel field and represents a percentage of the maximum available audio effect provided by the device. Zero is the minimum effect, while 100 is the maximum effect.

            The following audio effects apply to the final output mix. Any specification of a particular channel will be ignored.

            MCI_AMP_SET_BALANCE

              Sets the final output balance. Zero is defined as full left balance while one hundred is defined as full right balance.
            MCI_AMP_SET_BASS
              Controls bass as a percentage of the maximum achievable effect.
            MCI_AMP_SET_GAIN
              Sets the gain as a percentage of the maximum achievable effect.
            MCI_AMP_SET_PITCH
              Sets the pitch as a percentage of the maximum achievable effect.
            MCI_AMP_SET_TREBLE
              Controls treble as a percentage of the maximum achievable effect.
            The following items can be specified for the ulItem field of the data structure pointed to by pParam2 for use with the MCI_SET_ITEM flag:

            MCI_AMP_SET_AUDIO

              Used with the extended ampmix audio attribute flags.
            MCI_AMP_SET_MONITOR
              Used with the MCI_SET_ON or MCI_SET_OFF flags. It instructs the ampmix device to monitor the currently selected connector. This flag is typically used to listen to (monitor) a source while it is being recorded by another device.
            If the MCI_SET_ITEM flag is set and MCI_AMP_SET_AUDIO is in the ulItem field of MCI_AMP_SET_PARMS, the connector specified in ulValue can be modified with the following audio attribute flags in ulAudio and the appropriate level in ulLevel.

            MCI_AMP_SET_ALC

              The ulLevel field in MCI_AMP_SET_PARMS contains the auto-level control setting as a percentage (0-100) for the connector specified in ulValue.
            MCI_AMP_SET_BALANCE
              The ulLevel field in MCI_AMP_SET_PARMS contains the balance setting as a percentage (0-100) for the connector specified in ulValue.
            MCI_AMP_SET_BASS
              The ulLevel field in MCI_AMP_SET_PARMS contains the bass setting as a percentage (0-100) for the connector specified in ulValue.
            MCI_AMP_SET_CHORUS
              The ulLevel field in MCI_AMP_SET_PARMS contains the chorus setting as a percentage (0-100) for the connector specified in ulValue.
            MCI_AMP_SET_CROSSOVER
              The ulLevel field in MCI_AMP_SET_PARMS contains the crossover setting as a percentage (0-100) for the connector specified in ulValue.
            MCI_AMP_SET_CUSTOM1
              The ulLevel field in MCI_AMP_SET_PARMS contains the custom effect setting as a percentage (0-100). for the connector specified in ulValue.
            MCI_AMP_SET_CUSTOM2
              The ulLevel field in MCI_AMP_SET_PARMS contains the custom effect setting as a percentage (0-100) for the connector specified in ulValue.
            MCI_AMP_SET_CUSTOM3
              The ulLevel field in MCI_AMP_SET_PARMS contains the custom effect setting as a percentage (0-100) for the connector specified in ulValue.
            MCI_AMP_SET_GAIN
              The ulLevel field in MCI_AMP_SET_PARMS contains the gain setting as a percentage (0-100) for the connector specified in ulValue.
            MCI_AMP_SET_LOUDNESS
              The ulLevel field in MCI_AMP_SET_PARMS contains the loudness setting as a percentage (0-100) for the connector specified in ulValue.
            MCI_AMP_SET_MID
              The ulLevel field in MCI_AMP_SET_PARMS contains the mid setting as a percentage (0-100) for the connector specified in ulValue.
            MCI_AMP_SET_MONITOR
              The ulLevel field in MCI_AMP_SET_PARMS contains the monitor setting as a percentage (0-100) for the connector specified in ulValue.
            MCI_AMP_SET_MUTE
              The ulLevel field in MCI_AMP_SET_PARMS contains the mute setting for the connector specified in ulValue.
            MCI_AMP_SET_PITCH
              The ulLevel field in MCI_AMP_SET_PARMS contains the pitch setting as a percentage (0-100) for the connector specified in ulValue.
            MCI_AMP_SET_REVERB
              The ulLevel field in MCI_AMP_SET_PARMS contains the reverb setting as a percentage (0-100) for the connector specified in ulValue.
            MCI_AMP_SET_STEREOENHANCE
              The ulLevel field in MCI_AMP_SET_PARMS contains the stereo enhance setting as a percentage (0-100) for the connector specified in ulValue.
            MCI_AMP_SET_TREBLE
              The ulLevel field in MCI_AMP_SET_PARMS contains the treble setting as a percentage (0-100) for the connector specified in ulValue.
            MCI_AMP_SET_VOLUME
              The ulLevel field in MCI_AMP_SET_PARMS contains the volume setting as a percentage (0-100) for the connector specified in ulValue.
            CD Audio Extensions

            The following additional time formats are supported by CD audio devices and can be specified as values for the ulTimeFormat field of the data structure pointed to by pParam2 for use with the MCI_SET_TIME_FORMAT flag:

            MCI_FORMAT_MSF

              Indicates that all subsequent commands that specify time will do so in mm:ss:ff where mm is minutes, ss is seconds and ff is frames.
            MCI_FORMAT_TMSF
              Indicates that all subsequent commands that specify time will do so in tt:mm:ss:ff where tt is tracks, mm is minutes, ss is seconds, and ff is frames.
            CD/XA Extensions

            The following additional flags apply to the CD/XA device. Only one channel set function can be performed at a time with the MCI_SET message. The channel is specified in the ulChannel field of the data structure. The destination of the data in that channel is determined by the flags below. Only one destination can be selected at a time with the MCI_SET message. This message must be used with the MCI_CDXA_SET_CHANNEL flag and either the MCI_SET_ON or MCI_SET_OFF flags.

            MCI_CDXA_AUDIO_DEVICE

              Sends the audio stream to the audio card.
            MCI_CDXA_AUDIO_BUFFER
              Sends the audio stream to a playlist.
            MCI_CDXA_VIDEO_BUFFER
              Sends the video stream to a playlist.
            MCI_CDXA_DATA_BUFFER
              Sends the data stream to a playlist.
            Digital Video Extensions

            The following additional items can be specified for the ulItem field of the data structure pointed to by pParam2 for use with the MCI_SET_ITEM flag:

            MCI_DGV_SET_VIDEO_COMPRESSION

              Specifies the FOURCC compression format used for recording digital motion video. The values that can be specified are:

              MCI_VID_COMP_ULTI

                Ultimotion
              MCI_VID_COMP_DIB
                Raw (uncompressed format)
              MCI_VID_COMP_RT21
                Indeo 2.1
              MCI_VID_COMP_IV31
                Indeo 3.1
              The default compression type is specified through the Setup page for the digital video device. The initial setting is MCI_VID_COMP_ULTI until changed in the Setup.

              Note: Compressors are not available for FLIC, MPEG, and Indeo 3.2 in this version of OS/2.

            MCI_DGV_SET_RECORD_AUDIO
              Sets audio soundtrack recording on or off. The default is MCI_ON. This flag is used with MCI_ON or MCI_OFF.
            MCI_DGV_SET_REF_INTERVAL
              Sets the frequency at which reference frames (or I-frames) are to be compressed in the output data stream. A value of 0 results in no I-frames, a value of 1 causes every frame to be an I-frame, a value of 2 causes every other frame to be an I-frame, and so on. While there is no upper bound on the reference frame interval, a reference frame interval of 2 seconds or less produces the best results. The default reference frame interval is every 15th frame (once a second at the default frame rate of 15 frames per second).
            MCI_DGV_SET_BRIGHTNESS
              Sets the brightness level in the range 0-100.
            MCI_DGV_SET_CONTRAST
              Sets the contrast level in the range 0-100.
            MCI_DGV_SET_HUE
              Sets the hue level in the range 0-100, where 0 indicates maximum green tint, 100 indicates maximum red tint, and 50 indicates a neutral tint.
            MCI_DGV_SET_SATURATION
              Sets the saturation level in the range 0-100.
            MCI_DGV_SET_VIDEO_QUALITY
              Specifies the compression quality level setting to be sent to the CODEC. This value is in the range 0-10,000. Not all CODECs support setting a quality level. The default setting for video quality is 5000.
            MCI_DGV_SET_MONITOR
              Sets monitoring of the incoming video signal on or off. Must be used in conjunction with MCI_SET_ON or MCI_SET_OFF. The default setting is MCI_OFF.

              When monitoring is turned on, a monitor window is created. Monitor window function is similar to that of the playback window: half, normal, double size, clipping, and so on. When the monitor window is active and recording is not in progress, the monitor window will display the entire video source image, regardless of any source rectangle setting. During recording, only the area being captured is displayed.

              If a recording source rectangle is set, the monitor window continues to display the entire video source image with the source capture rectangle displayed in the monitor window image as an animated dashed-line rectangle (unless the source rectangle is the entire video source extent, that is, the entire image is to be captured, in which case the dashed-line rectangle is not displayed). The recording source rectangle may be set directly on the monitor window image by pointing to one corner of the area to be captured, pressing and holding the left mouse button to expand the rectangle to the opposite corner, and then releasing the left mouse button. The dashed-line rectangle will track the mouse movement while the button is held, and will "snap" to the nearest allowable rectangle size.

              Monitoring during real-time recording is supported but at a reduced performance. Monitoring can not be turned on or off during recording, that is, if it is on when recording starts it must remain on while recording is in progress; if it is off it must remain off while recording is in progress. Attempting to turn monitoring on or off during real-time recording will result in an MCIERR_INVALID_MODE return. Monitoring during frame-step recording is an application function.

              During monitoring, audio is passed through and heard on the speakers or headphones connected to the sound card, if present.

            MCI_DGV_SET_CHANNELS
              Sets the number of channels in the audio soundtrack recording (1 = mono, 2 = stereo). The default setting is 1.
            MCI_DGV_SET_SAMPLESPERSEC
              Sets the number of waveform samples per second in the audio soundtrack recording. This value is usually 11025, 22050, or 44100. The default is 11025.
            MCI_DGV_SET_BITSPERSAMPLE
              Sets the waveform sample size for the audio soundtrack recording. This value is usually 8 or 16 (bits). The default is 8.
            MCI_DGV_SET_TRANSPARENT_COLOR
              Sets the transparent color used as the chroma-key value for transparency in graphics on video overlay hardware devices. Specifying this item has the same effect as specifying MCI_DGV_SET_GRAPHIC_TRANSPARENT_COLOR. Video will be seen wherever the transparency color is painted in graphics. The color is set as a numeric value in the range 0...(n - 1). Where n represents the number of available colors.
            MCI_DGV_SET_GRAPHIC_TRANSPARENT_COLOR
              Sets the transparent color (used as the chroma-key value) for transparency in graphics on video-overlay hardware devices. Specifying this item has the same effect as specifying MCI_DGV_SET_TRANSPARENT_COLOR. Video will be seen wherever the transparency color is painted in graphics. The color is set as a numeric value in the range 0...(n - 1). Where n represents the number of available colors.
            MCI_DGV_SET_VIDEO_TRANSPARENT_COLOR
              Sets transparency color for transparency in video on dual-plane hardware devices. Graphics will be seen wherever the transparency color appears in the video. The color is set as a numeric value in the range 0...(n - 1). Where n represents the number of available colors.

              Note: Transparency color settings apply to both monitor and playback windows for a device instance, and while transparency values are maintained on a per-instance basis, most dual-plane video adapters only allow for a single setting that is applied to the entire screen. Default values for transparency colors are stored in a device .INI file.

            MCI_DGV_SET_VIDEO_RECORD_RATE
              Sets the frame rate for recording as an integral number of frames per second in the range 0-30. This sets the target capture rate, but there is no guarantee this rate will be attained. Drop frame records will be inserted into the output data stream to indicate frames dropped during the record process. The default record frame rate is 15 frames per second.
            MCI_DGV_SET_VIDEO_RECORD_FRAME_DURATION
              Sets the frame rate for recording as the time duration of each frame in microseconds. This is useful for setting non-integer frame rates, for example, 12.5 frames per second of a PAL videodisc: 1000000/12.5 = 8000 microseconds. The default frame duration is 66,667 microseconds (equivalent to 15 frames per second).
            The following additional time formats are supported by digital video devices and can be specified as values for the ulTimeFormat of the data structure pointed to by pParam2 for use with the MCI_SET_TIME_FORMAT flag:

            MCI_FORMAT_MILLISECONDS

              Changes the time format to milliseconds.
            MCI_FORMAT_MMTIME
              Changes the time format to MMTIME.
            MCI_FORMAT_FRAMES
              Changes the time format to frames.
            MCI_FORMAT_HMS
              Changes the time format to hours, minutes, seconds.
            MCI_FORMAT_HMSF
              Changes the time format to hours, minutes, seconds, and frames.
            Sequencer Extensions

            The following additional flags apply to MIDI sequencer devices. All sequencer flags are mutually exclusive, because only one set function can be performed at a time with the MCI_SET message.

            MCI_SEQ_SET_MASTER

              Sets the sequencer as a source of synchronization data and indicates that the type of synchronization is specified in the ulMaster field of the data structure identified by pParam2. The following constants are defined for the synchronization type:

              MCI_SEQ_MIDI

                The sequencer will send MIDI format synchronization data.
              MCI_SEQ_SMPTE
                The sequencer will send SMPTE format synchronization data.
              MCI_SEQ_NONE
                The sequencer will not send synchronization data.
              MCI_SEQ_SET_OFFSET
                Changes the SMPTE offset of a sequencer to that specified by the ulOffset field of the structure pointed to by pParam2. This only affects sequences with a SMPTE division type.
              MCI_SEQ_SET_PORT
                Sets the output MIDI port of a sequencer to that specified by the MIDI device ID in the ulPort field of the data structure identified by pParam2. The device will close the previous port (if any), and attempt to open and use the new port. If it fails, it will return an error and reopen the previously used port (if any). The following constants are defined for the ports:

                MCI_SET_NONE

                  Closes the previously used port (if any). The sequencer will behave exactly the same as if a port were open, except no MIDI message will be sent.
                MIDI_MAPPER
                  Sets the port opened to the MIDI Mapper.
                MCI_SEQ_SET_SLAVE
                  Sets the sequencer to receive synchronization data and indicates the type of synchronization is specified in the ulSlave field of the data structure pointed to by pParam2. The following constants are defined for the synchronization type:

                  MCI_SEQ_FILE

                    SetsthesequencertoreceivesynchronizationdatacontainedintheMIDIfile .
                  MCI _ SEQ _ MIDI
                    SetsthesequencertoreceiveMIDIformatsynchronizationdata .
                  MCI _ SEQ _ SMPTE
                    SetsthesequencertoreceiveSMPTEformatsynchronizationdata .
                  MCI _ SEQ _ NONE
                    SetsthesequencertoignoresynchronizationdatainaMIDIstream .
                  MCI _ SEQ _ SET _ TEMPO
                    ChangesthetempooftheMIDIsequencetothatspecifiedbytheulTempofieldofthestructurepointedtobypParam2 .ForsequenceswithdivisiontypePPQN ,tempoisspecifiedinbeatsperminute ;forsequenceswithdivisiontypeSMPTE ,tempoisspecifiedinframespersecond .ThisfunctionisnotcurrentlysupportedbytheIBMsequencer .
                  Thefollowingadditionaltime - formatflagsapplytoMIDIdevices :

                  MCI_SEQ_SET_SMPTE_24

                    Sets the time format to 24 frame SMPTE.
                  MCI_SEQ_SET_SMPTE_25
                    Sets the time format to 25 frame SMPTE.
                  MCI_SEQ_SET_SMPTE_30
                    Sets the time format to 30 frame SMPTE.
                  MCI_SEQ_SET_SMPTE_30DROP
                    Sets the time format to 30 drop-frame SMPTE.
                  MCI_SEQ_SET_SONGPTR
                    Sets the time format to song pointer units.
                  Videodisc Extensions

                  The following additional flags apply to videodisc devices:

                  MCI_VD_SET_CHANNEL

                    This flag sets the video channel to the channel specified in ulChannel of MCI_VD_SET_PARMS.
                  MCI_VD_SET_VIDEO
                    This flag sets Video.
                  MCI_VD_SET_DISPLAY
                    This flag sets the display index.
                  MCI_VD_SET_ON
                    This flag sets videodisc driver ON.
                  MCI_VD_SET_OFF
                    This flag sets videodisc driver OFF.
                  The following additional time formats apply to videodisc devices and can be specified as values for the ulTimeFormat field of the data structure pointed to by pParam2 for use with the MCI_SET_TIME_FORMAT flag:

                  MCI_FORMAT_CHAPTERS

                    This flag changes the time format to chapters.
                  MCI_FORMAT_FRAMES
                    This flag changes the time format to frames.
                  MCI_FORMAT_HMS
                    This flag changes the time format to hours, minutes, and seconds.
                  MCI_FORMAT_HMSF
                    This flag changes the time format to hours, minutes, seconds, and frames.
                  The MCI_VD_SET_CHANNEL and MCI_VD_SET_VIDEO flags are mutually exclusive and must be used with the MCI_VD_SET_ON and MCI_VD_SET_OFF flags.

                  Video Overlay Extensions

                  The following additional items apply to video overlay devices and can be specified for the ulItem field of the data structure pointed to by pParam2 for use with the MCI_SET_ITEM flag:

                  MCI_OVLY_SET_IMAGE_FILE_FORMAT

                    Sets the specified image file format in which the image capture is to be stored (when saved). This format must be specified by a four-character code (for example, MMOT or OS13), and must be one of the currently supported and installed MMIO image file formats, or the device-specific format. This does not effect the loading or restoring of images. It overwrites any previous file-format value, such as that obtained through a LOAD operation.
                  MCI_OVLY_SET_IMAGE_COMPRESSION
                    This flag sets the compression type used for saving still images. The specified compression type is used if it is supported by the device, the file format, or both. The compression type is not used if it contradicts settings for file format, BITSPERPEL, or PELFORMAT.

                    If the compression type value is valid, it supersedes any image quality setting and overwrites any format tag or compression value obtained by a LOAD operation. However, it does not affect the loading or restoring of images.

                    Compression algorithms are often proprietary and can require hardware assistance for performance. Therefore, when possible, the setting of this item is controlled by the device. If the specified compression type is not compatible with file format or BITSPERPEL settings, the device selects a compression type based on the file format, PELFORMAT, and quality settings.

                    If the compression type is not available, the device returns "function not supported" and uses the current setting.

                    M-Motion specific: The default is MCI_IMG_COMP_NONE.

                  MCI_OVLY_SET_IMAGE_BITSPERPEL
                    Sets the number of bits per pixel used for the image file to be saved. Generally supported values are those defined for OS/2 2.0 bit maps. Some devices might support other values.

                    The value specified for this setting might not be the same as the number of colors currently visible on the display. Selecting a BITSPERPEL value greater than that currently displayed results in unused colors. Selecting a BITSPERPEL value less than that currently displayed results in a degradation of color and a reduced quality image.

                    Most file formats do not support all BITSPERPEL values. This item overwrites any BITSPERPEL value obtained by a LOAD operation. However, it does not affect the loading or restoring of images.

                    Some devices are not capable of adjusting the number of colors to be saved in the image file. When this is the case, the device captures and saves the image in whatever number of colors it supports. The actual value used can be obtained using the MCI_OVLY_STATUS_IMAGE_BITSPERPEL flag.

                    If variable BITSPERPEL representation is not available, the device returns "function not supported" and uses the current setting.

                    M-Motion specific: The default is 12.

                  MCI_OVLY_SET_IMAGE_PELFORMAT
                    This flag sets the pixel format used for saving bit maps. This value indicates the desired image file color representation, and is used in conjunction with the BITSPERPEL value. Supported pixel format values are:

                    MCI_IMG_PALETTE

                      A palettized video image with 1, 4, or 8 bits per pixel.
                    MCI_IMG_RGB
                      An RGB video image with 16 or 24 bits per pixel.
                    MCI_IMG_YUV
                      A YUVB video image with 9, 12, or 16 bits per pixel.
                    Most file formats do not support all pixel formats. This item overwrites any pixel format value obtained by a LOAD operation. However, it does not affect the loading or restoring of images.

                    Some devices are not capable of adjusting the color representation of the image. When this is the case, the device captures and saves the image in whatever color representation it supports. If variable color representation is not available, the device returns "function not supported" and uses the current setting.

                    M-Motion specific: The default is MCI_IMG_YUV.

                  MCI_OVLY_SET_BRIGHTNESS
                    This flag sets the brightness level in the range 0-100.
                  MCI_OVLY_SET_CONTRAST
                    This flag sets the contrast level in the range 0-100.
                  MCI_OVLY_SET_HUE
                    This flag sets the hue level in the range 0-100. A value of 50 indicates neutral tint.
                  MCI_OVLY_SET_SATURATION
                    This flag sets the saturation level in the range 0-100.
                  MCI_OVLY_SET_SHARPNESS
                    This flag sets the sharpness level in the range 0-100.
                  MCI_OVLY_SET_GREYSCALE
                    This flag turns the grey scale on or off. Must be used in conjunction with MCI_SET_ON or MCI_SET_OFF.
                  MCI_OVLY_SET_IMAGE_QUALITY
                    This flag sets the specified image quality level. This item indicates the perceived quality of the image to be saved and allows the device to select the most appropriate compression method when more than one is available. The value specified for this item can affect the size of the resulting file.

                    This item overwrites any quality value obtained by a LOAD operation. However, it does not affect the loading or restoring of images. If image quality is not previously set, the device selects a compression scheme as accurately as possible.

                    If variable image quality is not available, the device returns "function not supported" and uses the current setting.

                    Supported values are:

                    MCI_IMG_QUALITY_HIGH

                      This flag normally describes photo-realistic images with high resolution and color content.
                    MCI_IMG_QUALITY_MED
                      This flag normally describes images such as complete graphs, charts, or diagrams, with fewer color transitions and complexity.
                    MCI_IMG_QUALITY_LOW
                      This flag normally describes images such as cartoons and simple drawings.
                    M-Motion specific: The default is MCI_IMG_QUALITY_HIGH.
                  MCI_OVLY_SET_IMAGE_COMPRESSION_METHOD
                    This flag sets the method by which image compression or decompression is done. Supported values and their meanings are:

                    MCI_CODEC_DEFAULT

                      This flag selects the default compression method specified in the INI file.
                    MCI_CODEC_SW_ONLY
                      This flag selects to use software emulation as the compression method.
                    MCI_CODEC_HW
                      This flag selects to use the compression method supported by the hardware, if available. Otherwise, software emulation is used.
                    MCI_OVLY_SET_MINIMUM_VIDEO_REFRESH_RATE
                      This flag sets the minimum refresh rate for the device instance. This is the minimum frame display refresh rate the application will accept for this device instance. This parameter is used on hardware that can multiplex the digitization between different windows at reduced rates. The default is one, allowing degraded display on hardware that supports this capability.
                    Waveform Audio Extensions

                    The following additional flags apply to wave audio devices and are mutually exclusive. If MCI_WAVE_SET_FORMATTAG is specified, the driver can change other settings to maintain compatibility. After setting the waveform format, the other parameters can be set as necessary within the currently selected waveform format. An error will be returned if the requested change results in an unsupported configuration.

                    An application can use the MCI_STATUS message to see if any of the other settings were changed to maintain a valid configuration.

                    MCI_WAVE_SET_FORMATTAG

                      Sets the format type used for playing, recording, and saving to the usFormatTag field of the MCI_WAVE_SET_PARMS data structure. Refer to the RIFF WAVE format documentation for more information. The following constants are defined to set the format type. Additional subtype values can be found in OS2MEDEF.H.

                      MCI_WAVE_FORMAT_PCM

                        Changes the format to pulse code modulation (PCM).
                      MCI_WAVE_FORMAT_ADPCM
                        Changes the format to adaptive differential pulse code modulation (ADPCM).
                      MCI_WAVE_FORMAT_IBM_CVSD
                        Changes the format to IBM Speech Viewer.
                      MCI_WAVE_FORMAT_ALAW
                        Changes the format to A-Law.
                      MCI_WAVE_FORMAT_MULAW
                        Changes the format to Mu-Law.
                      MCI_WAVE_FORMAT_IBM_ALAW
                        Changes the format to A-Law.
                      MCI_WAVE_FORMAT_IBM_MULAW
                        Changes the format to Mu-Law.
                      MCI_WAVE_FORMAT_OKI_ADPCM
                        Changes the format to OKI ADPCM.
                      MCI_WAVE_FORMAT_DVI_ADPCM
                        Changes the format to DVI ADPCM.
                      MCI_WAVE_FORMAT_IBM_ADPCM
                        Changes the format to ADPCM.
                      MCI_WAVE_FORMAT_DIGISTD
                        Changes the format to IBM Digispeech (standard format).
                      MCI_WAVE_FORMAT_DIGIFIX
                        Changes the format to IBM Digispeech (fixed format).
                      MCI_WAVE_FORMAT_AVC_ADPCM
                        Changes the format to AVC ADPCM.
                      MCI_WAVE_FORMAT_CT_ADPCM
                        Changes the format to Creative Labs ADPCM.
                      MCI_WAVE_FORMAT_MPEG1
                        Changes the format to MPEG audio.
                      MCI_WAVE_SET_CHANNELS
                        Sets the channel count used for playing, recording, and saving to the usChannels field of the MCI_WAVE_SET_PARMS data structure.
                      MCI_WAVE_SET_SAMPLESPERSEC
                        Sets the samples per second used for playing, recording, and saving to the ulSamplesPerSec field of the MCI_WAVE_SET_PARMS data structure.
                      MCI_WAVE_SET_AVGBYTESPERSEC
                        Sets the bytes per second used for playing, recording, and saving to the ulAvgBytesPerSec field of the MCI_WAVE_SET_PARMS data structure. Playback software may use this number to estimate required buffer sizes.
                      MCI_WAVE_SET_BLOCKALIGN
                        Sets the block alignment used for playing, recording, and saving to the usBlockAlign field of the MCI_WAVE_SET_PARMS data structure.
                      MCI_WAVE_SET_BITSPERSAMPLE
                        Sets the bits per sample used for playing, recording, and saving to the usBitsPerSample field of the MCI_WAVE_SET_PARMS data structure.
                      The following additional time format flags apply to wave audio devices and can be specified for the ulTimeFormat field: for use with the MCI_SET_TIME_FORMAT flag:

                      MCI_FORMAT_SAMPLES

                        Change time format to samples.
                      MCI_FORMAT_BYTES
                        Change time format to bytes.


                      [Back] [Next]