MCI_CUT command
The MCI_CUT command removes data from the file and copies it to the clipboard. Digital-video devices recognize this command.
To send this command, call the mciSendCommand function with the following parameters.
MCIERROR mciSendCommand(
MCIDEVICEID wDeviceID,
MCI_CUT,
DWORD dwFlags,
(DWORD) (LPMCI_DGV_CUT_PARMS) lpCut
);
Parameters
-
wDeviceID
-
Device identifier of the MCI device that is to receive the command message.
-
dwFlags
-
MCI_NOTIFY, MCI_WAIT, or MCI_TEST. For information about these flags, see The Wait, Notify, and Test Flags.
-
lpCut
-
Pointer to an MCI_DGV_CUT_PARMS structure.
Return Value
Returns zero if successful or an error otherwise.
Remarks
The following additional flags apply to digital-video devices:
-
MCI_DGV_CUT_AT
-
A rectangle is included in the rc member of the structure identified by lpCut. The rectangle specifies the portion of each frame to cut. If the flag is omitted, MCI_CUT cuts the entire frame.
-
MCI_DGV_CUT_AUDIO_STREAM
-
An audio-stream number is included in the dwAudioStream member of the structure identified by lpCut. 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, data from all audio and video streams is cut.)
-
MCI_DGV_CUT_VIDEO_STREAM
-
A video-stream number is included in the dwVideoStream member of the structure identified by lpCut. 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, data from all audio and video streams is cut.)
-
MCI_FROM
-
A starting location is included in the dwFrom member of the structure identified by lpCut. The units assigned to the position values are specified with the MCI_SET_TIME_FORMAT flag of the MCI_SET command.
-
MCI_TO
-
An ending location is included in the dwTo member of the structure identified by lpCut. The units assigned to the position values are specified with the MCI_SET_TIME_FORMAT flag of MCI_SET.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client |
Windows 2000 Professional [desktop apps only] |
| Minimum supported server |
Windows 2000 Server [desktop apps only] |
| Header |
|