comando MCI_SAVE
O comando MCI_SAVE salva o arquivo atual. Os dispositivos que modificam arquivos não devem destruir a cópia original até receberem a mensagem de salvamento. Os dispositivos de áudio de sobreposição de vídeo e forma de onda reconhecem esse comando. Embora os dispositivos de vídeo digital e os sequenciadores MIDI também reconheçam esse comando, os drivers MCIAVI e MCISEQ não o implementam.
Para enviar esse comando, chame a função mciSendCommand com os parâmetros a seguir.
MCIERROR mciSendCommand(
MCIDEVICEID wDeviceID,
MCI_SAVE,
DWORD dwFlags,
(DWORD) (LPMCI_SAVE_PARMS ) lpSave
);
Parâmetros
-
wDeviceID
-
Identificador de dispositivo do dispositivo MCI que deve receber a mensagem de comando.
-
dwFlags
-
MCI_NOTIFY, MCI_WAIT ou, para dispositivos de vídeo digital e VCR, MCI_TEST. Para obter informações sobre esses sinalizadores, consulte Os Sinalizadores de Espera, Notificação e Teste.
-
lpSave
-
Ponteiro para uma estrutura MCI_SAVE_PARMS . (Dispositivos com parâmetros adicionais podem substituir essa estrutura por uma estrutura específica do dispositivo.)
Valor Retornado
Retornará zero se tiver êxito ou um erro, caso contrário.
Comentários
Esse comando é compatível com dispositivos que retornam TRUE quando você chama o comando MCI_GETDEVCAPS com o sinalizador MCI_GETDEVCAPS_CAN_SAVE.
O seguinte sinalizador adicional se aplica a todos os dispositivos que dão suporte a MCI_SAVE:
-
MCI_SAVE_FILE
-
O membro lpfilename da estrutura identificada por lpSave contém um endereço de um buffer que contém o nome do arquivo de destino.
Os seguintes sinalizadores adicionais são usados com o tipo de dispositivo digitalvideo :
-
MCI_DGV_RECT
-
O membro rc da estrutura identificada por lpSave contém um retângulo válido. O retângulo especifica uma região do buffer de quadros que será salva no arquivo especificado. O primeiro par de coordenadas especifica o canto superior esquerdo do retângulo; o segundo par especifica a largura e a altura. Os dispositivos de vídeo digital devem usar o comando MCI_CAPTURE para capturar o conteúdo do buffer de quadros. (Os dispositivos de sobreposição de vídeo também devem usar MCI_CAPTURE.) Esse sinalizador é para compatibilidade com o conjunto de comandos de sobreposição de vídeo MCI existente.
-
MCI_DGV_SAVE_ABORT
-
Interrompe uma operação de salvamento em andamento. Esse deve ser o único sinalizador presente.
-
MCI_DGV_SAVE_KEEPRESERVE
-
O espaço em disco não utilizado deixado do comando MCI_RESERVE original não está desalocado.
Para dispositivos de vídeo digital, o parâmetro lpSave aponta para uma estrutura MCI_DGV_SAVE_PARMS .
O seguinte sinalizador adicional é usado com o tipo de dispositivo de sobreposição :
-
MCI_OVLY_RECT
-
O membro rc da estrutura identificada por lpSave contém um retângulo de exibição válido indicando a área do buffer de vídeo a ser salva.
Para dispositivos de sobreposição de vídeo, o parâmetro lpSave aponta para uma estrutura MCI_OVLY_SAVE_PARMS .
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 |
|