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

Статья
11/20/2024

Функция AVISaveV создает файл путем объединения потоков данных из других файлов или из памяти.

Синтаксис

HRESULT AVISaveVA(
  LPCSTR               szFile,
  CLSID                *pclsidHandler,
  AVISAVECALLBACK      lpfnCallback,
  int                  nStreams,
  PAVISTREAM           *ppavi,
  LPAVICOMPRESSOPTIONS *plpOptions
);

Параметры

szFile

Строка, завершающаяся значением NULL, содержащая имя файла для сохранения.

pclsidHandler

Указатель на обработчик файлов, используемый для записи файла. Файл создается путем вызова функции AVIFileOpen с помощью этого обработчика. Если обработчик не указан, по умолчанию выбирается из реестра на основе расширения файла.

lpfnCallback

Указатель на функцию обратного вызова, используемую для отображения сведений о состоянии, и позволить пользователю отменить операцию сохранения.

nStreams

Количество сохраненных потоков.

ppavi

Указатель на массив указателей на структуры функций AVISTREAM. Массив использует один указатель для каждого потока.

plpOptions

Указатель на массив указателей на структуры AVICOMPRESSOPTIONS. Массив использует один указатель для каждого потока.

Возвращаемое значение

Возвращает AVIERR_OK, если успешно или ошибка в противном случае.

Замечания

Эта функция эквивалентна функции AVISave, за исключением передачи потоков в массиве вместо переменного числа аргументов.

Эта функция создает файл, копирует потоковые данные в файл, закрывает файл и освобождает ресурсы, используемые новым файлом. Последние два параметра этой функции — это массивы, которые определяют потоки для сохранения в файле и определяют параметры сжатия этих потоков.

Приложение должно выделить память для структур AVICOMPRESSOPTIONS и массив указателей на эти структуры.

Аргумент ppavi содержит адрес указателя на интерфейс IAVIStream.

Заметка

Заголовок vfw.h определяет AVISaveV как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 2000 Профессиональный [только классические приложения]
минимальный поддерживаемый сервер	Windows 2000 Server [только классические приложения]
целевая платформа	Виндоус
заголовка	vfw.h
библиотеки	Vfw32.lib
DLL	Avifil32.dll

См. также

функции AVIFile

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

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