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


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

Функция AVIStreamRead считывает аудио, видео или другие данные из потока в соответствии с типом потока.

Синтаксис

HRESULT AVIStreamRead(
  PAVISTREAM pavi,
  LONG       lStart,
  LONG       lSamples,
  LPVOID     lpBuffer,
  LONG       cbBuffer,
  LONG       *plBytes,
  LONG       *plSamples
);

Параметры

pavi

Дескриптор открытого потока.

lStart

Первый образец для чтения.

lSamples

Число считываемых выборок. Можно также указать значение AVISTREAMREAD_CONVENIENT, чтобы обработчик потока определял количество считываемых выборок.

lpBuffer

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

cbBuffer

Размер буфера, на который указывает lpBuffer, в байтах.

plBytes

Указатель на буфер, который получает количество байтов данных, записанных в буфер, на который ссылается lpBuffer. Это значение может иметь значение NULL.

plSamples

Указатель на буфер, который получает количество выборок, записанных в буфер, на который ссылается lpBuffer. Это значение может иметь значение NULL.

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

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

Код возврата Описание
AVIERR_BUFFERTOOSMALL
Размер буфера cbBuffer был меньше, чем одна выборка данных.
AVIERR_MEMORY
Недостаточно памяти для завершения операции чтения.
AVIERR_FILEREAD
Ошибка диска при чтении файла.

Комментарии

Если lpBuffer имеет значение NULL, эта функция не считывает данные; Он возвращает сведения о размере считываемых данных.

Аргумент pavi является указателем на интерфейс IAVIStream .

Требования

Требование Значение
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header vfw.h
Библиотека Vfw32.lib
DLL Avifil32.dll

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

Функции AVIFile

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