Função AVISaveW (vfw.h)

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

Sintaxe

HRESULT AVISaveW(
  LPCWSTR              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 de 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.

...

Valor de retorno

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

Observações

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 informações de status 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 .

Requisitos

Consulte também

do AVIFile Functions

de Macros e Funções do AVIFile