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	Mmsystem.h (incluir Windows.h)

Confira também

MCI

Comandos MCI