Digital Video Extensions

DWORD lParam1 The following extensions apply to digital-video devices:

MCI_STATUS_ITEM

Indicates the dwItem field of the data structure identified by lParam2 contains a constant specifying which status item to obtain. The status item information is returned in the dwReturn field of the data structure. The following additional status constants are defined for digital-video devices:


MCI_DGV_STATUS_AUDIO

The dwReturn field 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 field 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 wave audio command status level.

MCI_DGV_STATUS_AUDIO_RECORD

The dwReturn field returns MCI_ON or MCI_OFF reflecting the state set by the MCI_SETAUDIO_RECORD option for the MCI_SETAUDIO command.

MCI_DGV_STATUS_AUDIO_SOURCE

The dwReturn field returns the current audio digitizer source:

MCI_DGV_SETAUDIO_LEFT—

Specifies the left audio channel.

MCI_DGV_SETAUDIO_RIGHT—

Specifies the right audio channel.

MCI_DGV_SETAUDIO_AVERAGE—

Specifies the average of the left and right audio channels.

MCI_DGV_SETAUDIO_STEREO—

Specifies stereo.

MCI_DGV_STATUS_AVGBYTESPERSEC

The dwReturn field returns the average number of bytes per second used for recording.

MCI_DGV_STATUS_BASS

The dwReturn field returns the current audio bass level. Use the MCI_DGV_STATUS_NOMINAL with this flag to obtain the nominal level.

MCI_DGV_STATUS_BITSPERPEL

The dwReturn field returns the number of bits per pixel used for saving captured or recorded data.

MCI_DGV_STATUS_BITSPERSAMPLE

The dwReturn field returns the number of bits per sample the device uses recording. This applies only to devices supporting the PCM format.

MCI_DGV_STATUS_BLOCKALIGN

The dwReturn field returns the alignment of data blocks relative to the start of the input waveform.

MCI_DGV_STATUS_BRIGHTNESS

The dwReturn field returns the current video brightness level. Use the MCI_DGV_STATUS_NOMINAL with this flag to obtain the nominal level.

MCI_DGV_STATUS_COLOR

The dwReturn field returns the current color level. Use the MCI_DGV_STATUS_NOMINAL with this flag to obtain the nominal level.

MCI_DGV_STATUS_CONTRAST

The dwReturn field returns the current contrast level. Use the MCI_DGV_STATUS_NOMINAL with this flag to obtain the nominal level.

MCI_DGV_STATUS_FILEFORMAT

The dwReturn field returns the current file format for recording or saving.

MCI_DGV_STATUS_FILE_MODE

The dwReturn field 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 field 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 devices.

MCI_DGV_STATUS_FORWARD

The dwReturn field returns TRUE if the device direction is forward or the device is not playing.

MCI_DGV_STATUS_FRAME_RATE

The dwReturn field must be used with the MCI_DGV_STATUS_NOMINAL and/or the MCI_DGV_STATUS_RECORD flags. 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 only, the nominal frame rate associated with the file is returned. In all cases the units are in frames per second times 1000.

MCI_DGV_STATUS_GAMMA

The dwReturn field returns the current gamma value. Use the MCI_DGV_STATUS_NOMINAL with this flag to obtain the nominal level.

MCI_DGV_STATUS_KEY_COLOR

The dwReturn field returns the current key-color value.

MCI_DGV_STATUS_KEY_INDEX

The dwReturn field returns the current key-index value.

MCI_DGV_STATUS_MEDIA_PRESENT

The dwReturn field returns TRUE.

MCI_DGV_STATUS_MONITOR

The dwReturn field returns a constant indicating the source of the current presentation. The following constants are defined:

MCI_DGV_MONITOR_INPUT—

Indicates the input is the source.

MCI_DGV_MONITOR_FILE—

Indicates a file is the source.

MCI_DGV_STATUS_MONITOR_METHOD


The dwReturn field returns a constant indicating the method used for input monitoring. The following constants are defined:


MCI_DGV_METHOD_PRE—

Indicates input-pre monitoring.

MCI_DGV_METHOD_POST—

Indicates input-post monitoring.

MCI_DGV_METHOD_DIRECT—

Indicates input-direct monitoring.

MCI_DGV_STATUS_HPAL

The dwReturn field 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 field 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_NOMINAL_RATE

The dwReturn field returns the nominal frame rate associated with the file. The units are in frames per second times 1000.

MCI_DGV_STATUS_PAUSE_MODE

The dwReturn field returns MCI_MODE_PLAY if the device was paused while playing and returns MCI_MODE_RECORD if the device was paused while recording. The message returns MCIERR_NONAPPLICABLE_FUNCTION as an error return if the device is not paused.

MCI_DGV_STATUS_SIZE

The dwReturn field returns the approximate playback duration of compressed data that the reserved workspace will hold. The duration units are in 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_SAMPLESPERSECOND

The dwReturn field returns the number of samples per second recorded.

MCI_DGV_STATUS_SEEK_EXACTLY

The dwReturn field returns TRUE or FALSE indicating whether or not seek exactly is set.

MCI_DGV_STATUS_SHARPNESS

The dwReturn field returns the current sharpness level. Use the MCI_DGV_STATUS_NOMINAL with this flag to obtain the nominal level.

MCI_DGV_STATUS_SMPTE

The dwReturn field returns the SMPTE (Society of Motion Picture Engineers) time code associated with the current position in the workspace.

MCI_DGV_STATUS_SPEED

The dwReturn field returns the current playback speed.

MCI_DGV_STATUS_STILL_FILEFORMAT

The dwReturn field returns the current file format for MCI_CAPTURE.

MCI_DGV_STATUS_TINT

The dwReturn field returns the current video tint level. Use the MCI_DGV_STATUS_NOMINAL with this flag to obtain the nominal level.

MCI_DGV_STATUS_TREBLE

The dwReturn field returns the current audio treble level. Use the MCI_DGV_STATUS_NOMINAL with this flag to obtain the nominal level.

MCI_DGV_STATUS_UNSAVED

The dwReturn field returns TRUE if there is recorded data in the workspace that might be lost as a result of MCI_CLOSE, MCI_LOAD, MCI_RECORD, MCI_RESERVE, MCI_CUT, MCI_DELETE, or MCI_PASTE. FALSE is returned otherwise.

MCI_DGV_STATUS_VIDEO

The dwReturn field returns whether video is enabled (MCI_ON) or disabled (MCI_OFF).

MCI_DGV_STATUS_VIDEO_RECORD

The dwReturn field returns MCI_ON or MCI_OFF, reflecting the state set by the MCI_SETVIDEO_RECORD option of the MCI_SETVIDEO command.

MCI_DGV_STATUS_VIDEO_SOURCE

The dwReturn field returns a constant indicating the type of video source set by the MCI_SETVIDEO_SOURCE option of the MCI_SETVIDEO command.

MCI_DGV_STATUS_VIDEO_SRC_NUM

The dwReturn field returns the number within its type of the video-input source currently active.

MCI_DGV_STATUS_VOLUME

The dwReturn field returns the average of the volume to the left and right speakers. Use the MCI_DGV_STATUS_NOMINAL with this flag to obtain the nominal level.

MCI_DGV_STATUS_WINDOW_VISIBLE

The dwReturn field returns TRUE if the window is not hidden.

MCI_DGV_STATUS_WINDOW_MINIMIZED

The dwReturn field returns TRUE if the window is minimized.

MCI_DGV_STATUS_WINDOW_MAXIMIZED

The dwReturn field returns TRUE if the window is maximized.


MCI_DGV_STATUS_DISKSPACE

The lpstrDrive field 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 MCI_RESERVE in the dwReturn field of the data structure identified by lParam2. The disk space is measured in units of the current time format.

MCI_DGV_STATUS_LEFT

Indicates the constant specified by the dwItem applies to the left audio channel.

MCI_DGV_STATUS_RIGHT

Indicates the constant specified by the dwItem applies to the right audio channel.

MCI_DGV_STATUS_INPUT

Indicates the constant specified by the dwItem applies to the input.

MCI_DGV_STATUS_OUTPUT

Indicates the constant specified by the dwItem applies to the output.

MCI_DGV_STATUS_NOMINAL

Indicates the constant specified by the dwItem requests the nominal value rather than the current value.

MCI_DGV_STATUS_RECORD

Indicates the frame rate returned for the MCI_DGV_STATUS_FRAME_RATE flag is the rate used for compression.

MCI_DGV_STATUS_REFERENCE

The dwReference field returns the nearest key-frame image that precedes the frame specified in the dwReference field of the data structure identified by lParam2.

LPMCI_DGV_STATUS_PARMS lParam2

Specifies a far pointer to the MCI_DGV_STATUS_PARMS data structure.

Return Value

Returns zero if successful. Otherwise, it returns an MCI error code.