Função AVISaveA (vfw.h)

A função AVISave cria um arquivo combinando fluxos de dados de outros arquivos ou de memória.

Sintaxe

HRESULT AVISaveA(
  LPCSTR               szFile,
  CLSID                *pclsidHandler,
  AVISAVECALLBACK      lpfnCallback,
  int                  nStreams,
  PAVISTREAM           pfile,
  LPAVICOMPRESSOPTIONS lpOptions,
  ...                  
);

Parâmetros

szFile

Cadeia de caracteres terminada em nulo que contém o nome do arquivo a ser salvo.

pclsidHandler

Ponteiro para o manipulador de arquivos usado para gravar o arquivo. O arquivo é criado chamando a função AVIFileOpen usando esse manipulador. Se um manipulador não for especificado, um padrão será selecionado no registro com base na extensão de arquivo.

lpfnCallback

Ponteiro para uma função de retorno de chamada para a operação de salvamento.

nStreams

Número de fluxos salvos no arquivo.

pfile

Ponteiro para um fluxo AVI. Esse parâmetro é emparelhado com lpOptions. O par de parâmetros pode ser repetido como um número variável de argumentos.

lpOptions

Ponteiro para uma estrutura AVICOMPRESSOPTIONS definida pelo aplicativo que contém as opções de compactação para o fluxo referenciado por pavi. Esse parâmetro é emparelhado com pavi. O par de parâmetros pode ser repetido como um número variável de argumentos.

...

Retornar valor

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

Comentários

Essa função cria um arquivo, copia dados de fluxo no arquivo, fecha o arquivo e libera os recursos usados pelo novo arquivo. Os dois últimos parâmetros dessa função identificam um fluxo para salvar no arquivo e definem as opções de compactação desse fluxo. Ao salvar mais de um fluxo em um arquivo AVI, repita esses dois parâmetros específicos do fluxo para cada fluxo no arquivo.

Uma função de retorno de chamada (referenciada usando lpfnCallback) pode exibir status informações e permitir que o usuário cancele a operação de salvamento. A função de retorno de chamada usa o seguinte formato:

LONG PASCAL SaveCallback(int nPercent)  

O parâmetro nPercent especifica a porcentagem do arquivo salvo.

A função de retorno de chamada deverá retornar AVIERR_OK se a operação deve continuar e AVIERR_USERABORT se o usuário quiser anular a operação de salvamento.

O argumento pavi é um ponteiro para uma interface IAVIStream .

Observação

O cabeçalho vfw.h define AVISave como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

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]
Plataforma de Destino	Windows
Cabeçalho	vfw.h
Biblioteca	Vfw32.lib
DLL	Avifil32.dll

Confira também

Funções AVIFile

Funções e macros do AVIFile