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 |
|