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 |