object

Object associated with this media control interface command. The object can be one of the following:

• Device type
  
• Device name
  
• Filename
  
• Alias
AUDIOSYNC
Returns the audio synchronization adjust value. This value is always expressed in MMTIME units. The default value is 0.
AUDIOSYNC DIRECTION
Returns the direction of the adjustment in audio synchronization. This is forward of backward relative to video time. The default is forward.
BITSPERSAMPLE
Returns the currently set bits per sample used for playing, recording, and saving.
BRIGHTNESS
Returns the brightness level.
CHANNELS
Returns the currently set channel count used for playing, recording, and saving.
CLIPBOARD
Returns TRUE if compatible data is in the clipboard; otherwise, returns FALSE.
CONTRAST
Returns the contrast level.
CURRENT TRACK
Returns the current track.
DROPPEDFRAMEPCT
Returns the percentage of dropped frames for playback or recording operations. The value returned is in the range 0-100, where a value of 0 indicates that no frame drops are occurring or have occurred. A value of 100 indicates that all frames are being dropped or have been dropped.

This STATUS value can be queried during a recording operation to obtain the cumulative drops that have occurred since recording began. This value can also be queried during a playback operation to obtain the cumulative frame drops that have occurred since playback began or was resumed after a seek, pause, or stop. If the value is queried when the device is stopped, the percentage of dropped frames accumulated at the end of the last playback or recording operation that was performed is returned.

A value of 0 is returned if no playback or recording operations have been performed, the device is seeking or has been seeked, or the device is playing in scan mode.

GRAPHIC COLOR
Returns the value of the transparent color used as the "chroma-key" on video overlay hardware.
HORIZONTAL IMAGE EXTENT
Not supported.
HORIZONTAL VIDEO EXTENT
Returns the horizontal (X) extent of the currently loaded motion video.
HUE
Returns the hue level.
FORMAT TAG
Returns WAVE_FORMAT_PCM, the only format currently supported by the digital video device. However, if a movie is loaded that contains a format other than PCM, the format used in the movie will be returned.
FORWARD
Returns TRUE if the play direction is forward or if the device is not playing.
IMAGE BITSPERPEL
Returns the number of bits per pel for saving bit maps.
IMAGE PELFORMAT
Returns the pel format for saving bit maps or images.
LENGTH
Returns the length in the current time format.
LENGTH TRACK track_number
Returns the total number of frames in the track specified by track_number.
MEDIA PRESENT
Returns TRUE if the media is inserted in the device; otherwise, the return is FALSE.
MODE
Returns not ready, pause, play, record, seek, or stop for the current mode.
MONITOR
Returns ON or OFF.
MONITOR WINDOW HANDLE
Returns the handle of the window used for the monitor window.
NORMAL RATE
Returns the normal rate of the currently loaded motion video device element, in the current speed format, either as a percentage or in frames per second. Otherwise, returns 0.
NUMBER OF TRACKS
Returns the number of tracks on the media.
PASTE
Returns TRUE if compatible data is to be placed in clipboard; otherwise, returns FALSE.
POSITION
Returns the current position.
READY
Returns TRUE if the digital video device is ready.
RECORD AUDIO
Returns ON or OFF.
REDO
Returns TRUE if the redo operation can be performed; otherwise, returns FALSE.
REFERENCE FRAME INTERVAL
Returns the value of n where n refers to a reference frame being inserted every nth frame.
SAMPLESPERSEC
Returns the currently set samples per second used for playing, recording, and saving.
SATURATION
Returns the saturation level.
SPEED
Returns the current speed of the device in the currently specified speed format.
SPEED FORMAT
Returns the current speed format of the device.
TIME FORMAT
Returns the time format.
TRANSPARENT COLOR
Returns the value of the transparent color used as the "chroma-key" on video overlay hardware.
TUNER TV CHANNEL
Returns the channel that the tuner device is tuned to.
TUNER HIGH TV CHANNEL
Returns the highest channel for the region.
TUNER LOW TV CHANNEL
Returns the lowest channel for the region.
TUNER FINETUNE
Returns the fine-tuning value that the tuner device is tuned to.
TUNER FREQUENCY
Returns the frequency value that the tuner device is tuned to.
UNDO
Returns TRUE if the undo operation can be performed; otherwise, returns FALSE.
VALID SIGNAL
Returns TRUE if there is a signal present.
VERTICAL IMAGE EXTENT
Not supported.
VERTICAL VIDEO EXTENT
Returns the vertical (Y) extent of the currently loaded motion video.
VIDEO COMPRESSION
Returns the current FOURCC compression type used for recording of motion video.
VIDEO RECORD FRAME DURATION
Returns the frame rate for recording as the time duration of each frame in microseconds.
VIDEO RECORD RATE
Returns current rate for recording as an integral number of frames per second.
VIDEO QUALITY
Returns the motion video quality level.
VIDEO COLOR
Returns the value of the transparent color used as the "chroma-key" on video overlay hardware.
VOLUME
Returns the current volume setting. The volume is returned as a string in the format left:right where left and right are percentages of the maximum achievable effect for the left and right channels respectively. Leading zeros are suppressed for the volume level in each channel.
WINDOW HANDLE
Returns the handle of the window used for the digital video return value.
WAIT
The command is executed synchronously. The function waits until the requested action is complete before returning to the application. The WAIT keyword must be specified in order to receive return string information.
NOTIFY
The command is executed asynchronously, allowing control to be returned immediately to the application. When the requested action is complete, an MM_MCINOTIFY message is sent to the application window procedure.

---

[Back] [Next]