MCI_SET Parameter - ulParam1

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: MCI_SET]
[Next: MCI_SET Parameter - pParam2]