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 vídeo sobreposição e de áudio de 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 de MCI_SAVE_PARMS . (Dispositivos com parâmetros adicionais podem substituir essa estrutura por uma estrutura específica do dispositivo.)

Valor de retorno

Retorna zero se tiver êxito ou um erro de outra forma.

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 sinalizador adicional a seguir se aplica a todos os dispositivos que dão suporte a MCI_SAVE:

MCI_SAVE_FILE

O membro lpfilename da estrutura identificada pelo 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 pelo lpSave contém um retângulo válido. O retângulo especifica uma região do buffer de quadro 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 serve 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. Este deve ser o único sinalizador presente.

MCI_DGV_SAVE_KEEPRESERVE

O espaço em disco não utilizado que sobrou 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 pelo lpSave contém um retângulo de exibição válido que indica 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 de 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
Mmsystem.h (inclua Windows.h)

Confira também

MCI

Comandos MCI