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 cut from 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 cut from the workspace. The audio and video data cut are exclusive of this position. If this flag is omitted, the position defaults to the end of the workspace.

MCI_DGV_CUT_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 cut. When this flag is used, the frame is retained in the workspace and the area specified by the rectangle becomes black. If this flag is omitted, MCI_CUT defaults to the entire frame and removes the frame from the workspace.

MCI_DGV_CUT_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 cut video, you must also use the MCI_DGV_CUT_VIDEO_STREAM flag. (If neither flag is specified, all audio and video streams are cut.)

MCI_DGV_CUT_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 cut audio, you must also use the MCI_DGV_CUT_AUDIO_STREAM flag. (If neither flag is specified, all audio and video streams are cut.)

LPMCI_DGV_CUT_PARMS lParam2

Specifies a far pointer to an MCI_DGV_CUT_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.

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