img_decode_validate()

Поиск кодека для декодирования

Прототип:

#include <img.h>
                                       
int img_decode_validate( const img_codec_t *codecs,
                         size_t ncodecs,
                         io_stream_t *input,
                         unsigned *codec );

Аргументы:

codecs

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

ncodecs

Количество элементов массива codecs.

input

Источник входного сигнала.

codec

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

Библиотека:

img

Описание:

Функция находит подходящий кодек для декодирования.

Статусы операций:

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

IMG_ERR_OK

Успешное завершение; найден соответствующий кодек. Индекс подходящего кодека в массиве размещен в переменной codec.

IMG_ERR_DLL

Произошла ошибка при обработке динамической библиотеки кодека. Убедитесь, что библиотека существует и не повреждена.

IMG_ERR_FORMAT

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

IMG_ERR_NOTIMPL

Кодек, распознавший входные данные как поддерживаемый формат, не имеет метода валидации.

Классификация:

Графическая подсистема ЗОСРВ «Нейтрино», Библиотека Image

Безопасность использования

Обработчик прерываний

Нет

Обработчик сигналов

Нет

В потоке

Нет

Тематические ссылки:

img_decode_callouts_t, img_t, io_open()

Предыдущий раздел: Image API