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 |