comando MCI_PASTE

O comando MCI_PASTE cola dados da área de transferência em um arquivo. Os dispositivos de vídeo digital reconhecem esse comando.

Para enviar esse comando, chame a função mciSendCommand com os parâmetros a seguir.

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

Parâmetros

wDeviceID

Identificador de dispositivo do dispositivo MCI que deve receber a mensagem de comando.

dwFlags

MCI_NOTIFY, MCI_WAIT ou MCI_TEST. Para obter informações sobre esses sinalizadores, consulte Os Sinalizadores de Espera, Notificação e Teste.

lpPaste

Ponteiro para uma estrutura PARMS MCI_ DGV_ PASTE_ .

Valor Retornado

Retornará zero se tiver êxito ou um erro, caso contrário.

Comentários

Os seguintes sinalizadores adicionais se aplicam a dispositivos de vídeo digital:

MCI_DGV_PASTE_AT

Um retângulo é incluído no membro rc da estrutura identificada por lpPaste. Os dois primeiros valores do retângulo especificam o ponto dentro do quadro para colocar as informações da área de transferência. Se a altura e a largura do retângulo forem diferentes de zero, o conteúdo da área de transferência será dimensionado para essas dimensões quando elas forem coladas no quadro. Se o sinalizador for omitido, MCI_PASTE usará como padrão todo o retângulo de quadro.

MCI_DGV_PASTE_AUDIO_STREAM

Um número de fluxo de áudio é incluído no membro dwAudioStream da estrutura identificada por lpPaste. Se houver apenas um fluxo de áudio na área de transferência, os dados de áudio serão colados no fluxo designado. Se houver mais de um fluxo de áudio na área de transferência, o fluxo indicará o número inicial das sequências de fluxo. Se você usar esse sinalizador e também quiser colar vídeo, também deverá usar o sinalizador MCI_DGV_PASTE_VIDEO_STREAM. (Se nenhum sinalizador for especificado, todos os fluxos de áudio e vídeo serão colados começando com o primeiro fluxo de áudio e vídeo. Cada fluxo colado mantém seu número de fluxo original.)

MCI_DGV_PASTE_INSERT

Os dados da área de transferência devem ser inseridos no workspace existente na posição especificada pelo sinalizador MCI_TO. Todos os dados existentes após o ponto de inserção são movidos no workspace para liberar espaço. Esse é o padrão.

MCI_DGV_PASTE_OVERWRITE

Os dados da área de transferência devem substituir os dados já presentes no workspace. Os dados do workspace substituídos seguem o ponto de inserção.

MCI_DGV_PASTE_VIDEO_STREAM

Um número de fluxo de vídeo está incluído no membro dwVideoStream da estrutura identificada por lpPaste. Se houver apenas um fluxo de vídeo na área de transferência, os dados de vídeo serão colados no fluxo designado. Se houver mais de um fluxo de vídeo na área de transferência, o fluxo indicará o número inicial das sequências de fluxo. Se você usar esse sinalizador e também quiser colar áudio, também deverá usar o sinalizador MCI_DGV_PASTE_AUDIO_STREAM. (Se nenhum sinalizador for especificado, todos os fluxos de áudio e vídeo serão colados começando com o primeiro fluxo de áudio e vídeo. Cada fluxo colado mantém seu número de fluxo original.)

MCI_TO

Um valor de posição é incluído no membro dwTo da estrutura identificada por lpPaste. O valor da posição especifica a posição para começar a colar dados no workspace. Se esse sinalizador for omitido, a posição usará como padrão a posição atual.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Cabeçalho	Mmsystem.h (incluir Windows.h)

Confira também

MCI

Comandos MCI