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

MCI_DGV_COPY_AT

Specifies a rectangle is included in the rc field of the data structure identified by lParam2. The rectangle specifies the portion of each frame to copy. If the flag is omitted, it defaults to the entire frame.

MCI_DGV_COPY_AUDIO_STREAM

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

MCI_DGV_COPY_VIDEO_STREAM

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

LPMCI_DGV_COPY_PARMS lParam2

Specifies a far pointer to an MCI_DGV_COPY_PARMS data structure.

Return Value

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

Comments

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