Função AVISaveVA (vfw.h)

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

Sintaxe

HRESULT AVISaveVA(
  LPCSTR               szFile,
  CLSID                *pclsidHandler,
  AVISAVECALLBACK      lpfnCallback,
  int                  nStreams,
  PAVISTREAM           *ppavi,
  LPAVICOMPRESSOPTIONS *plpOptions
);

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 usada para exibir status informações e para permitir que o usuário cancele a operação de salvamento.

nStreams

Número de fluxos a serem salvos.

ppavi

Ponteiro para uma matriz de ponteiros para as estruturas de função AVISTREAM . A matriz usa um ponteiro para cada fluxo.

plpOptions

Ponteiro para uma matriz de ponteiros para estruturas AVICOMPRESSOPTIONS . A matriz usa um ponteiro para cada fluxo.

Retornar valor

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

Comentários

Essa função é equivalente à função AVISave , exceto que os fluxos são passados em uma matriz em vez de como um número variável de argumentos.

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 são matrizes que identificam os fluxos a serem salvos no arquivo e definem as opções de compactação desses fluxos.

Um aplicativo deve alocar memória para as estruturas AVICOMPRESSOPTIONS e a matriz de ponteiros para essas estruturas.

O argumento ppavi contém o endereço de um ponteiro para uma interface IAVIStream .

Observação

O cabeçalho vfw.h define AVISaveV 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