Comando save
O comando save salva um arquivo MCI. 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 dão suporte a ele.
Para enviar esse comando, chame a função mciSendString com o parâmetro lpszCommand definido da seguinte maneira.
_stprintf_s(
lpszCommand,
TEXT("save %s %s %s"),
lpszDeviceID,
lpszFilename,
lpszFlags
);
Parâmetros
-
lpszDeviceID
-
Identificador de um dispositivo MCI. Esse identificador ou alias é atribuído quando o dispositivo é aberto.
-
lpszFilename
-
Sinalizador especificando o nome do arquivo que está sendo salvo e, opcionalmente, sinalizadores adicionais modificando a operação de salvamento. A tabela a seguir lista os tipos de dispositivo que reconhecem o comando save e os sinalizadores usados por cada tipo.
Valor Significado Significado digitalvideo abortar no retângulo filenamekeepreserve overlay no retângulo filename sequenciador filename Waveaudio filename A tabela a seguir lista os sinalizadores que podem ser especificados no parâmetro lpszFilename e seus significados.
Valor Significado abort Interrompe uma operação de salvamento em andamento. Se usado, este deve ser o único item presente. no retângulo Especifica um retângulo relativo à origem do buffer de quadro. O retângulo é especificado como X1 Y1 X2 Y2. As coordenadas X1 Y1 especificam o canto superior esquerdo e as coordenadas X2 Y2 especificam a largura e a altura. Para dispositivos de vídeo digital, o comando de captura é usado para capturar o conteúdo do buffer de quadros. filename Especifica o nome do arquivo a ser atribuído ao arquivo de dados. Se um caminho não for especificado, o arquivo será colocado no disco e no diretório especificado anteriormente no comando de reserva explícita ou implícita. Se a reserva não tiver sido emitida, a unidade e o diretório padrão serão aqueles associados à tarefa do aplicativo. Se um caminho for especificado, o dispositivo poderá exigir que ele esteja na unidade de disco especificada pela reserva explícita ou implícita. Este sinalizador é necessário. keepreserve Especifica que o espaço em disco não utilizado que sobrou do comando de reserva original não está desalocado. -
lpszFlags
-
Pode ser "wait", "notify" ou ambos. Para dispositivos de vídeo digital e VCR, "teste" também pode ser especificado. Para obter mais informações sobre esses sinalizadores, consulte Os Sinalizadores de Espera, Notificação e Teste.
Valor Retornado
Retornará zero se tiver êxito ou um erro, caso contrário.
Comentários
A variável filename será necessária se o dispositivo tiver sido aberto usando o identificador de dispositivo "novo".
Exemplos
O comando a seguir salva todo o buffer de vídeo em um arquivo chamado VCAPFILE. TGA.
save vboard c:\vcap\vcapfile.tga
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] |