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

Статья
11/20/2024

Функция AVIStreamOpenFromFile открывает один поток из файла.

Синтаксис

HRESULT AVIStreamOpenFromFileA(
  PAVISTREAM *ppavi,
  LPCSTR     szFile,
  DWORD      fccType,
  LONG       lParam,
  UINT       mode,
  CLSID      *pclsidHandler
);

Параметры

ppavi

Указатель на буфер, получающий новый дескриптор потока.

szFile

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

fccType

Четырехзначный код, указывающий тип открываемого потока. Ноль указывает, что любой поток можно открыть. Следующие определения применяются к данным, часто найденным в потоках AVI:

Ценность	Описание
streamtypeAUDIO	Указывает аудиопоток.
streamtypeMIDI	Указывает поток MIDI.
streamtypeTEXT	Указывает текстовый поток.
streamtypeVIDEO	Указывает видеопоток.

lParam

Поток типа, указанного в fccType для доступа. Этот параметр основан на нулях; используйте ноль, чтобы указать первое вхождение.

mode

Режим доступа для использования при открытии файла. Эта функция может открывать только существующие потоки, поэтому флаг режима OF_CREATE нельзя использовать. Дополнительные сведения о доступных флагах для параметра режима см. в функции OpenFile.

pclsidHandler

Указатель на идентификатор класса обработчика, который требуется использовать. Если значение равно NULL, система выбирает один из реестра на основе расширения файла или типа RIFF файла.

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

Возвращает ноль в случае успешного выполнения или ошибки в противном случае.

Замечания

Эта функция вызывает AVIFileOpen, AVIFileGetStreamи функции AVIFileRelease.

Заметка

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

Требования

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

См. также

функции AVIFile

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

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