MCI_STATUS
The MCI_STATUS
command retrieves information about an MCI device. All devices recognize this
command. Information is returned in the dwReturn member of the structure
identified by the lpStatus parameter.
MCIERROR mciSendCommand(MCIDEVICEID wDeviceID,
MCI_STATUS,
DWORD dwFlags, (DWORD)
(LPMCI_STATUS_PARMS) lpStatus);
Parameters
wDeviceID
Device
identifier of the MCI device that is to receive the command message.
dwFlags
MCI_NOTIFY,
MCI_WAIT, or, for digital-video and VCR devices, MCI_TEST. For information
about these flags, see The Wait, Notify, and Test Flags.
lpStatus
Address of an
MCI_STATUS_PARMS
structure. (Devices with extended command sets might replace this structure
with a device-specific structure.)
Return Values
Returns zero
if successful or an error otherwise.
Remarks
The following
additional standard and command-specific flags apply to all devices supporting MCI_STATUS:
MCI_STATUS_ITEM
Specifies
that the dwItem member of the structure identified by lpStatus
contains a constant specifying which status item to obtain. The following
constants define which status item to return in the dwReturn member of
the structure:
MCI_STATUS_CURRENT_TRACK
The dwReturn
member is set to the current track number. MCI uses continuous track numbers.
MCI_STATUS_LENGTH
The dwReturn
member is set to the total media length.
MCI_STATUS_MODE
The dwReturn
member is set to the current mode of the device. The modes include the
following:
MCI_MODE_NOT_READY
MCI_MODE_PAUSE
MCI_MODE_PLAY
MCI_MODE_STOP
MCI_MODE_OPEN
MCI_MODE_RECORD
MCI_MODE_SEEK
MCI_STATUS_NUMBER_OF_TRACKS
The dwReturn
member is set to the total number of playable tracks.
MCI_STATUS_POSITION
The dwReturn
member is set to the current position.
MCI_STATUS_READY
The dwReturn
member is set to TRUE if the device is ready; it is set to FALSE otherwise.
MCI_STATUS_TIME_FORMAT
The dwReturn
member is set to the current time format of the device. The time formats
include:
MCI_FORMAT_BYTES
MCI_FORMAT_FRAMES
MCI_FORMAT_HMS
MCI_FORMAT_MILLISECONDS
MCI_FORMAT_MSF
MCI_FORMAT_SAMPLES
MCI_FORMAT_TMSF
MCI_STATUS_START
Obtains the
starting position of the media. To get the starting position, combine this flag
with MCI_STATUS_ITEM and set the dwItem member of the structure
identified by lpStatus to MCI_STATUS_POSITION.
MCI_TRACK
Indicates a
status track parameter is included in the dwTrack member of the
structure identified by lpStatus. You must use this flag with the
MCI_STATUS_POSITION or MCI_STATUS_LENGTH constants. When used with
MCI_STATUS_POSITION, MCI_TRACK obtains the starting position of the specified
track. When used with MCI_STATUS_LENGTH, MCI_TRACK obtains the length of the
specified track. MCI uses continuous track numbers.
The following
additional flags are used with the cdaudio device type. These constants
are used in the dwItem member of the structure pointed to by the lpStatus
parameter when MCI_STATUS_ITEM is specified for the dwFlags parameter.
MCI_CDA_STATUS_TYPE_TRACK
The dwReturn
member is set to one of the following values:
MCI_CDA_TRACK_AUDIO
MCI_CDA_TRACK_OTHER
To use this
flag, the MCI_TRACK flag must be set, and the dwTrack member of the
structure identified by lpStatus must contain a valid track number.
MCI_STATUS_MEDIA_PRESENT
The dwReturn
member is set to TRUE if the media is inserted in the device; it is set to
FALSE otherwise.
The following
additional flags are used with the digitalvideo device type:
MCI_DGV_STATUS_DISKSPACE
The lpstrDrive
member of the structure identified by lpStatus specifies a disk drive
or, in some implementations, a path. The MCI_STATUS command returns the
approximate amount of disk space that could be obtained by the MCI_RESERVE command in the dwReturn
member of the structure identified by lpStatus. The disk space is
measured in units of the current time format.
MCI_DGV_STATUS_INPUT
The constant
specified by the dwItem member of the structure identified by lpStatus
applies to the input.
MCI_DGV_STATUS_LEFT
The constant
specified by the dwItem member of the structure identified by lpStatus
applies to the left audio channel.
MCI_DGV_STATUS_NOMINAL
The constant
specified by the dwItem member of the structure identified by lpStatus
requests the nominal value rather than the current value.
MCI_DGV_STATUS_OUTPUT
The constant
specified by the dwItem member of the structure identified by lpStatus
applies to the output.
MCI_DGV_STATUS_RECORD
The frame
rate returned for the MCI_DGV_STATUS_FRAME_RATE flag is the rate used for
compression.
MCI_DGV_STATUS_REFERENCE
The dwReturn
member of the structure identified by lpStatus returns the nearest key-frame
image that precedes the frame specified in the dwReference member.
MCI_DGV_STATUS_RIGHT
The constant
specified by the dwItem member of the structure identified by lpStatus
applies to the right audio channel.
The following
constants are used with the digitalvideo device type in the dwItem
member of the structure pointed to by the lpStatus parameter when MCI_STATUS_ITEM
is specified for the dwFlags parameter.
MCI_AVI_STATUS_AUDIO_BREAKS
The dwReturn
member returns the number of times the audio portion of the last AVI sequence
broke up. The system counts an audio break whenever it attempts to write audio
data to the device driver and discovers that the driver has already played all
of the available data. This flag is recognized only by the MCIAVI digital-video
driver.
MCI_AVI_STATUS_FRAMES_SKIPPED
The dwReturn
member returns the number of frames that were not drawn when the last AVI
sequence was played. This flag is recognized only by the MCIAVI digital-video
driver.
MCI_AVI_STATUS_LAST_PLAY_SPEED
The dwReturn
member returns a value representing how closely the actual playing time of the
last AVI sequence matched the target playing time. The value 1000 indicates
that the target time and the actual time were the same. A value of 2000, for
example, would indicate that the AVI sequence took twice as long to play as it
should have. This flag is recognized only by the MCIAVI digital-video driver.
MCI_DGV_STATUS_AUDIO
The dwReturn
member returns MCI_ON or MCI_OFF depending on the most recent MCI_SET_AUDIO
option for the MCI_SET
command. It returns MCI_ON if either or both speakers are enabled, and MCI_OFF
otherwise.
MCI_DGV_STATUS_AUDIO_INPUT
The dwReturn
member returns the approximate instantaneous audio level of the analog audio
signal. A value greater than 1000 implies there is clipping distortion. Some
devices can determine this value only while recording audio. This status value
has no associated MCI_SET or MCI_SETAUDIO command. This value is
related to, but normalized differently from, the waveform-audio command
MCI_WAVE_STATUS_LEVEL.
MCI_DGV_STATUS_AUDIO_RECORD
The dwReturn
member returns MCI_ON or MCI_OFF reflecting the state set by the
MCI_DGV_SETAUDIO_RECORD flag of the MCI_SETAUDIO command.
MCI_DGV_STATUS_AUDIO_SOURCE
The dwReturn
member returns the current audio digitizer source:
MCI_DGV_SETAUDIO_AVERAGE
Specifies the
average of the left and right audio channels.
MCI_DGV_SETAUDIO_LEFT
Specifies the
left audio channel.
MCI_DGV_SETAUDIO_RIGHT
Specifies the
right audio channel.
MCI_DGV_SETAUDIO_STEREO
Specifies
stereo.
MCI_DGV_STATUS_AUDIO_STREAM
The dwReturn
member returns the current audio-stream number.
MCI_DGV_STATUS_AVGBYTESPERSEC
The dwReturn
member returns the average number of bytes per second used for recording.
MCI_DGV_STATUS_BASS
The dwReturn
member returns the current audio bass level. Use MCI_DGV_STATUS_NOMINAL with
this flag to obtain the nominal level.
MCI_DGV_STATUS_BITSPERPEL
The dwReturn
member returns the number of bits per pixel used for saving captured or
recorded data.
MCI_DGV_STATUS_BITSPERSAMPLE
The dwReturn
member returns the number of bits per sample the device uses for recording.
This applies only to devices supporting the PCM format.
MCI_DGV_STATUS_BLOCKALIGN
The dwReturn
member returns the alignment of data blocks relative to the start of the input
waveform.
MCI_DGV_STATUS_BRIGHTNESS
The dwReturn
member returns the current video brightness level. Use MCI_DGV_STATUS_NOMINAL
with this flag to obtain the nominal level.
MCI_DGV_STATUS_COLOR
The dwReturn
member returns the current color level. Use MCI_DGV_STATUS_NOMINAL with this
flag to obtain the nominal level.
MCI_DGV_STATUS_CONTRAST
The dwReturn
member returns the current contrast level. Use MCI_DGV_STATUS_NOMINAL with this
flag to obtain the nominal level.
MCI_DGV_STATUS_FILEFORMAT
The dwReturn
member returns the current file format for recording or saving.
MCI_DGV_STATUS_FILE_MODE
The dwReturn
member returns the state of the file operation:
MCI_DGV_FILE_MODE_EDITING
Returned
during cut, copy, delete, paste, and undo operations.
MCI_DGV_FILE_MODE_IDLE
Returned when
the file is ready for the next operation.
MCI_DGV_FILE_MODE_LOADING
Returned
while the file is being loaded.
MCI_DGV_FILE_MODE_SAVING
Returned
while the file is being saved.
MCI_DGV_STATUS_FILE_COMPLETION
The dwReturn
member returns the estimated percentage a load, save, capture, cut, copy,
delete, paste, or undo operation has progressed. (Applications can use this to
provide a visual indicator of progress.) This flag is not supported by all
digital-video devices.
MCI_DGV_STATUS_FORWARD
The dwReturn
member returns TRUE if the device direction is forward or the device is not
playing.
MCI_DGV_STATUS_FRAME_RATE
The dwReturn
member must be used with MCI_DGV_STATUS_NOMINAL, MCI_DGV_STATUS_RECORD, or
both. When used with MCI_DGV_STATUS_RECORD, the current frame rate used for
recording is returned. When used with both MCI_DGV_STATUS_RECORD and
MCI_DGV_STATUS_NOMINAL, the nominal frame rate associated with the input video
signal is returned. When used with MCI_DGV_STATUS_NOMINAL, the nominal frame
rate associated with the file is returned. In all cases the units are in frames
per second multiplied by 1000.
MCI_DGV_STATUS_GAMMA
The dwReturn
member returns the current gamma value. Use MCI_DGV_STATUS_NOMINAL with this
flag to obtain the nominal level.
MCI_DGV_STATUS_HPAL
The dwReturn
member returns the ASCII decimal value for the current palette handle. The
handle is contained in the low-order word of the returned value.
MCI_DGV_STATUS_HWND
The dwReturn
member returns the ASCII decimal value for the current explicit or default
window handle associated with this device driver instance. The handle is
contained in the low-order word of the returned value.
MCI_DGV_STATUS_KEY_COLOR
The dwReturn
member returns the current key-color value.
MCI_DGV_STATUS_KEY_INDEX
The dwReturn
member returns the current key-index value.
MCI_DGV_STATUS_MONITOR
The dwReturn
member returns a constant indicating the source of the current presentation.
The following constants are defined:
MCI_DGV_MONITOR_FILE
A file is the
source.
MCI_DGV_MONITOR_INPUT
The input is
the source.
MCI_DGV_STATUS_MONITOR_METHOD
The dwReturn
member returns a constant indicating the method used for input monitoring. The
following constants are defined:
MCI_DGV_METHOD_DIRECT
Direct input
monitoring.
MCI_DGV_METHOD_POST
Post-input
monitoring.
MCI_DGV_METHOD_PRE
Pre-input
monitoring.
MCI_DGV_STATUS_PAUSE_MODE
The dwReturn
member returns MCI_MODE_PLAY if the device was paused while playing and returns
MCI_MODE_RECORD if the device was paused while recording. The command returns
MCIERR_NONAPPLICABLE_FUNCTION as an error return if the device is not paused.
MCI_DGV_STATUS_SAMPLESPERSECOND
The dwReturn
member returns the number of samples per second recorded.
MCI_DGV_STATUS_SEEK_EXACTLY
The dwReturn
member returns TRUE or FALSE indicating whether or not the seek exactly format is
set. (Applications can set this format by using the MCI_SET command with the
MCI_DGV_SET_SEEK_EXACTLY flag.)
MCI_DGV_STATUS_SHARPNESS
The dwReturn
member returns the current sharpness level. Use MCI_DGV_STATUS_NOMINAL with
this flag to obtain the nominal level.
MCI_DGV_STATUS_SIZE
The dwReturn
member returns the approximate playback duration of compressed data that the reserved
workspace will hold. The duration units are in the current time format. It
returns zero if there is no reserved disk space. The size returned is
approximate since the precise disk space for compressed data cannot, in
general, be predicted until after the data has been compressed.
MCI_DGV_STATUS_SMPTE
The dwReturn
member returns the SMPTE time code associated with the current position in the
workspace.
MCI_DGV_STATUS_SPEED
The dwReturn
member returns the current playback speed.
MCI_DGV_STATUS_STILL_FILEFORMAT
The dwReturn
member returns the current file format for the MCI_CAPTURE command.
MCI_DGV_STATUS_TINT
The dwReturn
member returns the current video tint level. Use MCI_DGV_STATUS_NOMINAL with
this flag to obtain the nominal level.
MCI_DGV_STATUS_TREBLE
The dwReturn
member returns the current audio treble level. Use MCI_DGV_STATUS_NOMINAL with
this flag to obtain the nominal level.
MCI_DGV_STATUS_UNSAVED
The dwReturn
member returns TRUE if there is recorded data in the workspace that might be
lost as a result of a MCI_CLOSE, MCI_LOAD, MCI_RECORDBEWKAT, MCI_RESERVE, MCI_CUT, MCI_DELETE, or MCI_PASTE command. The member
returns FALSE otherwise.
MCI_DGV_STATUS_VIDEO
The dwReturn
member returns MCI_ON if video is enabled or MCI_OFF if it is disabled.
MCI_DGV_STATUS_VIDEO_RECORD
The dwReturn
member returns MCI_ON or MCI_OFF, reflecting the state set by the
MCI_DGV_SETVIDEO_RECORD flag of the MCI_SETVIDEO command.
MCI_DGV_STATUS_VIDEO_SOURCE
The dwReturn
member returns a constant indicating the type of video source set by the
MCI_DGV_SETVIDEO_SOURCE flag of the MCI_SETVIDEO command.
MCI_DGV_STATUS_VIDEO_SRC_NUM
The dwReturn
member returns the number within its type of the video-input source currently
active.
MCI_DGV_STATUS_VIDEO_STREAM
The dwReturn
member returns the current video-stream number.
MCI_DGV_STATUS_VOLUME
The dwReturn
member returns the average of the volume to the left and right speakers. Use
MCI_DGV_STATUS_NOMINAL with this flag to obtain the nominal level.
MCI_DGV_STATUS_WINDOW_VISIBLE
The dwReturn
member returns TRUE if the window is not hidden.
MCI_DGV_STATUS_WINDOW_MINIMIZED
The dwReturn
member returns TRUE if the window is minimized.
MCI_DGV_STATUS_WINDOW_MAXIMIZED
The dwReturn
member returns TRUE if the window is maximized.
MCI_STATUS_MEDIA_PRESENT
The dwReturn
member returns TRUE.
For
digital-video devices, the lpStatus parameter points to an MCI_DGV_STATUS_PARMS structure.
The following
additional flags are used with the sequencer device type. These
constants are used in the dwItem member of the structure pointed to by
the lpStatus parameter when MCI_STATUS_ITEM is specified for the dwFlags
parameter.
MCI_SEQ_STATUS_DIVTYPE
The dwReturn
member is set to one of the following values indicating the current division
type of a sequence:
MCI_SEQ_DIV_PPQN
MCI_SEQ_DIV_SMPTE_24
MCI_SEQ_DIV_SMPTE_25
MCI_SEQ_DIV_SMPTE_30
MCI_SEQ_DIV_SMPTE_30DROP
MCI_SEQ_STATUS_MASTER
The dwReturn
member is set to the synchronization type used for master operation.
MCI_SEQ_STATUS_OFFSET
The dwReturn
member is set to the current SMPTE offset of a sequence.
MCI_SEQ_STATUS_PORT
The dwReturn
member is set to the MIDI device identifier for the current port used by the
sequence.
MCI_SEQ_STATUS_SLAVE
The dwReturn
member is set to the synchronization type used for slave operation.
MCI_SEQ_STATUS_TEMPO
The dwReturn
member is set to the current tempo of a MIDI sequence in beats per minute for
PPQN files, or frames per second for SMPTE files.
MCI_STATUS_MEDIA_PRESENT
The dwReturn
member is set to TRUE if the media is inserted in the device; it is set to
FALSE otherwise.
The following
additional flags are used with the vcr device type. These constants are
used in the dwItem member of the structure pointed to by the lpStatus
parameter when MCI_STATUS_ITEM is specified for the dwFlags parameter.
MCI_STATUS_MEDIA_PRESENT
The dwReturn
member is set to TRUE if the media is inserted in the device; it is set to
FALSE otherwise.
MCI_VCR_STATUS_ASSEMBLE_RECORD
The dwReturn
member is set to TRUE if assemble mode is on; it is set to FALSE otherwise.
MCI_VCR_STATUS_AUDIO_MONITOR
The dwReturn
member is set to a constant, indicating the currently selected audio-monitor
type.
MCI_VCR_STATUS_AUDIO_MONITOR_NUMBER
The dwReturn
member is set to the number of the currently selected audio-monitor type.
MCI_VCR_STATUS_AUDIO_RECORD
The dwReturn
member is set to TRUE if audio will be recorded when the next record command is
given; it is set to FALSE otherwise. If you specify MCI_TRACK in the dwFlags
parameter of this command, dwTrack contains the track this inquiry
applies to.
MCI_VCR_STATUS_AUDIO_SOURCE
The dwReturn
member is set to a constant, indicating the current audio-source type.
MCI_VCR_STATUS_AUDIO_SOURCE_NUMBER
The dwReturn
member is set to the number of the currently selected audio-source type.
MCI_VCR_STATUS_CLOCK
The dwReturn
member is set to the current clock value, in total clock increments.
MCI_VCR_STATUS_CLOCK_ID
The dwReturn
member is set to a number which uniquely describes the clock in use.
MCI_VCR_STATUS_COUNTER_FORMAT
The dwReturn
member is set to a constant describing the current counter format. For more
information, see the MCI_SET_TIME_FORMAT flag of the MCI_SET command.
MCI_VCR_STATUS_COUNTER_RESOLUTION
The dwReturn
member is set to a constant describing the resolution of the counter, and is
one of the following values:
MCI_VCR_COUNTER_RES_FRAMES
Counter has
resolution of frames.
MCI_VCR_COUNTER_RES_SECONDS
Counter has
resolution of seconds.
MCI_VCR_STATUS_COUNTER_VALUE
The dwReturn
member is set to the current counter reading, in the current counter-time
format.
MCI_VCR_STATUS_FRAME_RATE
The dwReturn
member is set to the current native frame rate of the device.
MCI_VCR_STATUS_INDEX
The dwReturn
member is set to a constant, describing the current contents of the on-screen
display, and is one of the following:
MCI_VCR_INDEX_COUNTER
MCI_VCR_INDEX_DATE
MCI_VCR_INDEX_TIME
MCI_VCR_INDEX_TIMECODE
MCI_VCR_STATUS_INDEX_ON
The dwReturn
member is set to TRUE if the on-screen display is on; it is set to FALSE
otherwise.
MCI_VCR_STATUS_MEDIA_TYPE
The dwReturn
member is set to one of the following:
MCI_VCR_MEDIA_8MM
MCI_VCR_MEDIA_HI8
MCI_VCR_MEDIA_VHS
MCI_VCR_MEDIA_SVHS
MCI_VCR_MEDIA_BETA
MCI_VCR_MEDIA_EDBETA
MCI_VCR_MEDIA_OTHER
MCI_VCR_STATUS_NUMBER
The dwNumber
member is set to the logical-tuner number when you use this flag with the
MCI_VCR_STATUS_TUNER_CHANNEL flag.
MCI_VCR_STATUS_NUMBER_OF_AUDIO_TRACKS
The dwReturn
member is set to the number of audio tracks that are independently selectable.
MCI_VCR_STATUS_NUMBER_OF_VIDEO_TRACKS
The dwReturn
member is set to the number of video tracks that are independently selectable.
MCI_VCR_STATUS_PAUSE_TIMEOUT
The dwReturn
member is set to the maximum duration, in milliseconds, of a pause command. The
return value of zero indicates that no time-out will occur.
MCI_VCR_STATUS_PLAY_FORMAT
The dwReturn
member is set to one of the following:
MCI_VCR_FORMAT_EP
MCI_VCR_FORMAT_LP
MCI_VCR_FORMAT_OTHER
MCI_VCR_FORMAT_SP
MCI_VCR_STATUS_POSTROLL_DURATION
The dwReturn
member is set to the length of the videotape that will play after the spot at
which it was stopped, in the current time format. This is needed to brake the
VCR tape transport from a stop or pause command.
MCI_VCR_STATUS_POWER_ON
The dwReturn
member is set to TRUE if the power is on; it is set to FALSE otherwise.
MCI_VCR_STATUS_PREROLL_DURATION
The dwReturn
member is set to the length of the videotape that will play before the spot at
which it was started, in the current time format. This is needed to stabilize
the VCR output.
MCI_VCR_STATUS_RECORD_FORMAT
The dwReturn
member is set to one of the following:
MCI_VCR_FORMAT_EP
MCI_VCR_FORMAT_LP
MCI_VCR_FORMAT_OTHER
MCI_VCR_FORMAT_SP
MCI_VCR_STATUS_SPEED
The dwReturn
member is set to the current speed. For more information, see the
MCI_VCR_SET_SPEED flag of the MCI_SET command.
MCI_VCR_STATUS_TIME_MODE
The dwReturn
member is set to one of the following:
MCI_VCR_TIME_COUNTER
MCI_VCR_TIME_DETECT
MCI_VCR_TIME_TIMECODE
For more
information, see the MCI_VCR_SET_TIME_MODE flag of the MCI_SET command.
MCI_VCR_STATUS_TIME_TYPE
The dwReturn
member is set to a constant describing the current time type in use (used by play, record, seek, and so on), and is one of
the following:
MCI_VCR_TIME_COUNTER
Counter is in
use.
MCI_VCR_TIME_TIMECODE
Timecode is
in use.
MCI_VCR_STATUS_TIMECODE_PRESENT
The dwReturn
member is set to TRUE if timecode is present at the current position in the
content; it is set to FALSE otherwise.
MCI_VCR_STATUS_TIMECODE_RECORD
The dwReturn
member is set to TRUE if the timecode will be recorded when the next record
command is given; it is set to FALSE otherwise.
MCI_VCR_STATUS_TIMECODE_TYPE
The dwReturn
member is set to a constant, describing the type of timecode that is directly
supported by the device, and is one of the following:
MCI_VCR_TIMECODE_TYPE_NONE
This device
does not use a timecode.
MCI_VCR_TIMECODE_TYPE_OTHER
This device
uses an unspecified timecode.
MCI_VCR_TIMECODE_TYPE_SMPTE
This device
uses SMPTE timecode.
MCI_VCR_TIMECODE_TYPE_SMPTE_DROP
This device
uses SMPTE drop timecode.
MCI_VCR_STATUS_TUNER_CHANNEL
The dwReturn
member is set to the current channel number. If you specify
MCI_VCR_STATUS_NUMBER in the dwFlags parameter of this command, dwNumber
contains the logical-tuner number this command applies to.
MCI_VCR_STATUS_VIDEO_MONITOR
The dwReturn
member is set to a constant, indicating the currently selected video-monitor
type.
MCI_VCR_STATUS_VIDEO_MONITOR_NUMBER
The dwReturn
member is set to the number of the currently selected video-monitor type.
MCI_VCR_STATUS_VIDEO_RECORD
The dwReturn
member is set to TRUE if video will be recorded when the next record command is
given; it is set to FALSE otherwise. If you specify MCI_TRACK in the dwFlags
parameter of this command, dwTrack contains the track this inquiry
applies to.
MCI_VCR_STATUS_VIDEO_SOURCE
The dwReturn
member is set to a constant indicating the currently selected video-source
type.
MCI_VCR_STATUS_VIDEO_SOURCE_NUMBER
The dwReturn
member is set to the number of the currently selected video-source type.
MCI_VCR_STATUS_WRITE_PROTECTED
The dwReturn
member is set to TRUE if the media is write-protected; it is set to FALSE
otherwise.
For VCR
devices, the lpStatus parameter points to an MCI_VCR_STATUS_PARMS structure.
Using the
MCI_STATUS_LENGTH flag to determine the length of the media always returns 2
hours for VCR devices, unless the length has been explicitly changed using the MCI_SET command.
The following
additional flags are used with the overlay device type. These constants
are used in the dwItem member of the structure pointed to by the lpStatus
parameter when MCI_STATUS_ITEM is specified for the dwFlags parameter.
MCI_OVLY_STATUS_HWND
The dwReturn
member is set to the handle of the window associated with the video-overlay
device.
MCI_OVLY_STATUS_STRETCH
The dwReturn
member is set to TRUE if stretching is enabled; it is set to FALSE otherwise.
MCI_STATUS_MEDIA_PRESENT
The dwReturn
member is set to TRUE if the media is inserted in the device; it is set to FALSE
otherwise.
The following
additional flags are used with the videodisc device type. These
constants are used in the dwItem member of the structure pointed to by
the lpStatus parameter when MCI_STATUS_ITEM is specified for the dwFlags
parameter.
MCI_STATUS_MEDIA_PRESENT
The dwReturn
member is set to TRUE if the media is inserted in the device; it is set to
FALSE otherwise.
MCI_STATUS_MODE
The dwReturn
member is set to the current mode of the device. Videodisc devices can return
the MCI_VD_MODE_PARK constant, in addition to the constants any device can
return, as documented with the dwFlags parameter.
MCI_VD_STATUS_DISC_SIZE
The dwReturn
member is set to the size of the loaded disc in inches (8 or 12).
MCI_VD_STATUS_FORWARD
The dwReturn
member is set to TRUE if playing forward; it is set to FALSE otherwise.
The MCI
videodisc device does not support this flag.
MCI_VD_STATUS_MEDIA_TYPE
The dwReturn
member is set to the media type of the inserted media. The following media
types can be returned:
MCI_VD_MEDIA_CAV
MCI_VD_MEDIA_CLV
MCI_VD_MEDIA_OTHER
MCI_VD_STATUS_SIDE
The dwReturn
member is set to 1 or 2 to indicate which side of the disc is loaded. Not all
videodisc devices support this flag.
MCI_VD_STATUS_SPEED
The dwReturn
member is set to the play speed in frames per second. The MCIPIONR.DRV device
driver returns MCIERR_UNSUPPORTED_FUNCTION.
The following
additional flags are used with the waveaudio device type. These
constants are used in the dwItem member of the structure pointed to by
the lpStatus parameter when MCI_STATUS_ITEM is specified for the dwFlags
parameter.
MCI_WAVE_FORMATTAG
The dwReturn
member is set to the current format tag used for playing, recording, and
saving.
MCI_WAVE_INPUT
The dwReturn
member is set to the wave input device used for recording. If no device is in
use and no device has been explicitly set, then the error return is MCIERR_WAVE_INPUTUNSPECIFIED.
MCI_WAVE_OUTPUT
The dwReturn
member is set to the wave output device used for playing. If no device is in use
and no device has been explicitly set, then the error return is
MCIERR_WAVE_OUTPUTUNSPECIFIED.
MCI_WAVE_STATUS_AVGBYTESPERSEC
The dwReturn
member is set to the current bytes per second used for playing, recording, and
saving.
MCI_WAVE_STATUS_BITSPERSAMPLE
The dwReturn
member is set to the current bits per sample used for playing, recording, and
saving PCM formatted data.
MCI_WAVE_STATUS_BLOCKALIGN
The dwReturn
member is set to the current block alignment used for playing, recording, and
saving.
MCI_WAVE_STATUS_CHANNELS
The dwReturn
member is set to the current channel count used for playing, recording, and
saving.
MCI_WAVE_STATUS_LEVEL
The dwReturn
member is set to the current record or playback level of PCM formatted data.
The value is returned as an 8- or 16-bit value, depending on the sample size
used. The right or mono channel level is returned in the low-order word. The
left channel level is returned in the high-order word.
MCI_WAVE_STATUS_SAMPLESPERSEC
The dwReturn
member is set to the current samples per second used for playing, recording,
and saving.
See Also