Функция AVISaveA (vfw.h)

Статья
08/27/2023

Функция 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

См. также раздел

Функции AVIFile

Функции и макросы AVIFile

Поделиться через