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

Статья
11/20/2024

Функция AVIFileOpen открывает файл AVI и возвращает адрес интерфейса файла, используемого для доступа к нему. Библиотека AVIFile поддерживает количество раз открытия файла, но не количество выпусков. Используйте функцию AVIFileRelease для освобождения файла и уменьшения количества.

Синтаксис

HRESULT AVIFileOpenA(
  PAVIFILE *ppfile,
  LPCSTR   szFile,
  UINT     uMode,
  LPCLSID  lpHandler
);

Параметры

ppfile

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

szFile

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

uMode

Режим доступа для использования при открытии файла. Режим доступа по умолчанию — OF_READ. Следующие режимы доступа можно указать с помощью AVIFileOpen.

Ценность	Значение
OF_CREATE	Создает новый файл. Если файл уже существует, он усечен до нулевой длины.
OF_PARSE	Пропускает длительные операции, например создание индекса. Задайте этот флаг, если вы хотите, чтобы функция возвращалась как можно быстрее, например, если вы собираетесь запрашивать свойства файла, но не считываете файл.
OF_READ	Открывает файл для чтения.
OF_READWRITE	Открывает файл для чтения и записи.
OF_SHARE_DENY_NONE	Открывает файл неисключительно. Другие процессы могут открывать файл с доступом на чтение или запись. AVIFileOpen завершается ошибкой, если другой процесс открыл файл в режиме совместимости.
OF_SHARE_DENY_READ	Открывает файл неисключительно. Другие процессы могут открывать файл с доступом на запись. AVIFileOpen завершается ошибкой, если другой процесс открыл файл в режиме совместимости или имеет доступ на чтение к нему.
OF_SHARE_DENY_WRITE	Открывает файл неисключительно. Другие процессы могут открывать файл с доступом на чтение. AVIFileOpen завершается ошибкой, если другой процесс открыл файл в режиме совместимости или имеет доступ на запись к нему.
OF_SHARE_EXCLUSIVE	Открывает файл и запрещает другим процессам доступ к нему. AVIFileOpen завершается ошибкой, если любой другой процесс открыл файл.
OF_WRITE	Открывает файл для записи.

lpHandler

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

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

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

Возвращаемый код	Описание
AVIERR_BADFORMAT	Не удалось прочитать файл, указывающий поврежденный файл или нераспознанный формат.
AVIERR_MEMORY	Не удалось открыть файл из-за нехватки памяти.
AVIERR_FILEREAD	При чтении файла произошла ошибка диска.
AVIERR_FILEOPEN	При открытии файла произошла ошибка диска.
REGDB_E_CLASSNOTREG	Согласно реестру, тип файла, указанного в AVIFileOpen, не имеет обработчика для его обработки.

Замечания

Заметка

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

Требования

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

См. также

функции AVIFile

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

AVIFileRelease

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