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. |