Метод IAVIStream::ReadFormat (vfw.h)
Метод ReadFormat получает сведения о формате из потока. Заполняет и возвращает структуру данными в буфере, определяемом приложением. Если буфер не указан, определяет размер буфера, необходимый для получения буфера данных формата. Вызывается, когда приложение использует функцию AVIStreamReadFormat .
Синтаксис
HRESULT ReadFormat(
LONG lPos,
LPVOID lpFormat,
LONG *lpcbFormat
);
Параметры
lPos
Положение образца или кадра.
lpFormat
Указатель на буфер для данных формата. Укажите значение NULL , чтобы запросить требуемый размер буфера.
lpcbFormat
Указатель на буфер, который получает размер (в байтах) буфера, заданного lpFormat. При вызове этого метода содержимое этого параметра указывает размер буфера, указанный в lpFormat. Когда этот метод возвращает управление приложению, содержимое этого параметра указывает объем считываемых данных или требуемый размер буфера.
Возвращаемое значение
Возвращает значение HRESULT, определенное OLE.
Комментарии
Тип данных, хранящихся в потоке, определяет сведения о формате и структуру, содержащую сведения о формате. Обработчик потока должен возвращать все применимые сведения о формате в этой структуре, включая сведения о палитре, если формат использует палитру. Обработчик потока не должен возвращать данные потока со структурой .
Стандартные обработчики видеопотока предоставляют сведения о формате в структуре BITMAPINFOHEADER . Стандартные обработчики аудиопотока предоставляют сведения о формате в структуре PCMWAVEFORMAT . Другие потоки данных могут использовать другие структуры, описывающие потоковые данные.
Для обработчиков, написанных на C++, ReadFormat имеет следующий синтаксис:
HRESULT ReadFormat(LONG lPos, LPVOID lpFormat,
LONG *lpcbFormat)
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 2000 Professional [только классические приложения] |
| Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
| Целевая платформа | Windows |
| Header | vfw.h |
| Библиотека | Vfw32.lib |