Digital Video Extensions

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

MCI_FROM

Specifies that a beginning position is included in the dwFrom field of the data structure identified by lParam2. The position specifies the start of the range to delete in the workspace. If this flag is omitted, the position defaults to the current position.

MCI_TO

Specifies that an ending position is included in the dwTo field of the data structure identified by lParam2. The position specifies the end of the range to delete from the workspace. The audio and video data deleted are exclusive of this position. If this flag is omitted, the position defaults to last valid frame in the workspace.

MCI_DGV_DELETE_AT

Specifies that a rectangle is included in the rc field of the data structure identified by lParam2. The rectangle specifies the portion of each frame to delete. When this flag is used, the frame is retained in the workspace and the area specified by the rectangle becomes black. If the flag is omitted, MCI_DELETE defaults to the entire frame and removes the frame from the workspace.

MCI_DGV_DELETE_AUDIO_STREAM

Indicates that an audio-stream number is included in the dwAudioStream field of the data structure identified by lParam2. If you use this flag and also want to delete video, you must also use the MCI_DGV_DELETE_VIDEO_STREAM flag. (If neither flag is specified, data from all audio and video streams is deleted.)

MCI_DGV_DELETE_VIDEO_STREAM

Indicates that a video-stream number is included in the dwVideoStream field of the data structure identified by lParam2. If you use this flag and also want to delete audio, you must also use the MCI_DGV_DELETE_AUDIO_STREAM flag. (If neither flag is specified, data from all audio and video streams is deleted.)

LPMCI_DGV_DELETE_PARMS lParam2

Specifies a far pointer to an MCI_DGV_DELETE_PARMS data structure.

Return Value

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

Comments

The change becomes permanent only when the data is explicitly saved. However, playback functions as if the data had actually been removed. This command is especially useful for recording with devices that do not support recording into a file containing existing data.

The units used for the position values are specified using the MCI_SET_TIME_FORMAT flag of the MCI_SET command.