Função AVISaveVA (vfw.h)

Artigo
11/20/2024

A função AVISaveV cria um arquivo combinando fluxos de dados de outros arquivos ou de 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 informações de status 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 do 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.

Valor de retorno

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

Observações

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 .

Nota

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 do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows 2000 Professional [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows 2000 Server [somente aplicativos da área de trabalho]
da Plataforma de Destino	Windows
cabeçalho	vfw.h
biblioteca	Vfw32.lib
de DLL	Avifil32.dll

Consulte também

do AVIFile Functions

de Macros e Funções do AVIFile

Compartilhar via