MCI_PASTE 命令

MCI_PASTE命令将数据从剪贴板粘贴到文件中。 数字视频设备可识别此命令。

若要发送此命令，请使用以下参数调用 mciSendCommand 函数。

MCIERROR mciSendCommand(
  MCIDEVICEID wDeviceID, 
  MCI_PASTE, 
  DWORD dwFlags, 
  (DWORD) (LPMCI_DGV_PASTE_PARMS) lpPaste
);

parameters

wDeviceID

要接收命令消息的 MCI 设备的设备标识符。

dwFlags

MCI_NOTIFY、MCI_WAIT或MCI_TEST。 有关这些标志的信息，请参阅 等待、通知和测试标志。

lpPaste

指向 MCI_ DGV_ PASTE_ PARMS 结构的指针。

返回值

如果成功，则返回零，否则返回错误。

备注

以下附加标志适用于数字视频设备：

MCI_DGV_PASTE_AT

矩形包含在由 lpPaste 标识的结构的 rc 成员中。 矩形的前两个值指定用于放置剪贴板信息的帧内的点。 如果矩形高度和宽度不为零，剪贴板内容在粘贴到框架中时会缩放到这些尺寸。 如果省略标志，MCI_PASTE默认为整个框架矩形。

MCI_DGV_PASTE_AUDIO_STREAM

音频流编号包含在 lpPaste 标识的结构的 dwAudioStream 成员中。 如果剪贴板上只有一个音频流，则音频数据将粘贴到指定的流中。 如果剪贴板上存在多个音频流，则流指示流序列的起始编号。 如果使用此标志并且还想要粘贴视频，则还必须使用 MCI_DGV_PASTE_VIDEO_STREAM 标志。 (如果未指定这两个标志，则从第一个音频和视频流开始粘贴所有音频和视频流。每个粘贴的流都保留其原始流 number.)

MCI_DGV_PASTE_INSERT

剪贴板数据应插入到MCI_TO标志指定位置的现有工作区中。 在工作区中移动插入点后的任何现有数据以腾出空间。 这是默认值。

MCI_DGV_PASTE_OVERWRITE

剪贴板数据应替换工作区中已存在的数据。 替换的工作区数据紧跟插入点。

MCI_DGV_PASTE_VIDEO_STREAM

视频流编号包含在由 lpPaste 标识的结构的 dwVideoStream 成员中。 如果剪贴板上只有一个视频流，则视频数据将粘贴到指定的流中。 如果剪贴板上存在多个视频流，则流指示流序列的起始编号。 如果使用此标志并且还想要粘贴音频，则还必须使用 MCI_DGV_PASTE_AUDIO_STREAM 标志。 (如果未指定这两个标志，则从第一个音频和视频流开始粘贴所有音频和视频流。每个粘贴的流都保留其原始流 number.)

MCI_TO

位置值包含在由 lpPaste 标识的结构的 dwTo 成员中。 位置值指定开始将数据粘贴到工作区的位置。 如果省略此标志，则位置默认为当前位置。

要求

要求	值
最低受支持的客户端	Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器	Windows 2000 Server [仅限桌面应用]
标头	Mmsystem.h (包括 Windows.h)

另请参阅

Mci

MCI 命令