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
MCI_VID_COMP_DIB
Raw (uncompressed format)
MCI_VID_COMP_RT21
MCI_VID_COMP_IV31
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
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.
pParam2 (PMCI_SET_PARMS)
A pointer to an MCI_SET_PARMS
data structure. (This is the default parameter data structure.) Devices
with extended command sets might replace this pointer with a pointer to
a device-specific data structure as follows:
PMCI_AMP_SET_PARMS
PMCI_CDXA_SET_PARMS
PMCI_DGV_SET_PARMS
PMCI_SEQ_SET_PARMS
PMCI_VD_SET_PARMS
PMCI_OVLY_SET_PARMS
PMCI_WAVE_SET_PARMS
A
pointer to the MCI_WAVE_SET_PARMS
data structure. This data structure replaces the standard default data
structure, MCI_SET_PARMS.
rc (ULONG)
Return
codes indicating success or type of failure:
MCIERR_SUCCESS
MMPM/2 command completed successfully.
MCIERR_OUT_OF_MEMORY
MCIERR_INVALID_DEVICE_ID
MCIERR_MISSING_PARAMETER
Missing
parameter for this command.
MCIERR_DRIVER
Internal
MMPM/2 driver error.
MCIERR_INVALID_FLAG
Invalid
flag specified for this command.
MCIERR_UNSUPPORTED_FLAG
Flag not supported by this MMPM/2 driver for this
command.
MCIERR_MISSING_FLAG
Flag
missing for this MMPM/2 command.
MCIERR_FLAGS_NOT_COMPATIBLE
The flags cannot be used together.
MCIERR_MISSING_STRING_ARGUMENT
Missing required string argument.
MCIERR_INVALID_ITEM_FLAG
Invalid item flag specified for this command.
MCIERR_INSTANCE_INACTIVE
MCIERR_OUTOFRANGE
Value given is out of range.
MCIERR_UNSUPPORTED_FUNCTION
[Back: MCI_SET Return Value - rc]
[Next: MCI_SET - Remarks]