Функция AVISaveA (vfw.h)
Функция AVISave создает файл путем объединения потоков данных из других файлов или из памяти.
Синтаксис
HRESULT AVISaveA(
LPCSTR szFile,
CLSID *pclsidHandler,
AVISAVECALLBACK lpfnCallback,
int nStreams,
PAVISTREAM pfile,
LPAVICOMPRESSOPTIONS lpOptions,
...
);
Параметры
szFile
Строка, завершающаяся значением NULL, содержащая имя файла для сохранения.
pclsidHandler
Указатель на обработчик файлов, используемый для записи файла. Файл создается путем вызова функции AVIFileOpen с помощью этого обработчика. Если обработчик не указан, в реестре выбирается значение по умолчанию в зависимости от расширения файла.
lpfnCallback
Указатель на функцию обратного вызова для операции сохранения.
nStreams
Число потоков, сохраненных в файле.
pfile
Указатель на поток AVI. Этот параметр связан с lpOptions. Пару параметров можно повторить как переменное число аргументов.
lpOptions
Указатель на определяемую приложением структуру AVICOMPRESSOPTIONS , содержащую параметры сжатия для потока, на который ссылается pavi. Этот параметр связан с pavi. Пару параметров можно повторить как переменное число аргументов.
...
Возвращаемое значение
Возвращает AVIERR_OK в случае успешного выполнения или ошибки в противном случае.
Комментарии
Эта функция создает файл, копирует данные потока в файл, закрывает файл и освобождает ресурсы, используемые новым файлом. Последние два параметра этой функции определяют поток для сохранения в файле и определяют параметры сжатия этого потока. При сохранении нескольких потоков в файле AVI повторите эти два параметра для каждого потока в файле.
Функция обратного вызова (на которую ссылается lpfnCallback) может отображать сведения о состоянии и позволить пользователю отменить операцию сохранения. Функция обратного вызова использует следующий формат:
LONG PASCAL SaveCallback(int nPercent)
Параметр nPercent указывает процент сохраненного файла.
Функция обратного вызова должна возвращать AVIERR_OK, если операция должна продолжаться, и AVIERR_USERABORT, если пользователь хочет прервать операцию сохранения.
Аргумент pavi является указателем на интерфейс IAVIStream .
Примечание
Заголовок vfw.h определяет AVISave в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Использование псевдонима, не зависящий от кодирования, с кодом, который не является нейтральным для кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или времени выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 2000 Professional [только классические приложения] |
| Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
| Целевая платформа | Windows |
| Header | vfw.h |
| Библиотека | Vfw32.lib |
| DLL | Avifil32.dll |