Метод CEnumMediaTypes.Next

  • Статья
  • Чтение занимает 2 мин

Метод Next извлекает указанное количество типов мультимедиа. Этот метод реализует метод IEnumMediaTypes::Next .

Синтаксис

HRESULT Next(
   ULONG         cMediaTypes,
   AM_MEDIA_TYPE **ppMediaTypes,
   ULONG         *pcFetched
);

Параметры

cMediaTypes

Количество извлекаемых типов носителей.

ppMediaTypes

Массив указателей на AM_MEDIA_TYPE структуры, размер cPins.

pcFetched

Указатель на переменную, получающую количество типов носителей, возвращаемых методом. Может иметь значение NULL , если cMediaTypes имеет значение 1.

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

Возвращает одно из значений HRESULT , показанное в следующей таблице.

Код возврата Описание
S_FALSE
 Не удалось получить столько типов мультимедиа, сколько запрошено.
S_OK
 Успешно.
E_INVALIDARG
 Недопустимый аргумент.
E_POINTER
 Аргумент указателя NULL.
VFW_E_ENUM_OUT_OF_SYNC
 Состояние контакта изменилось и теперь не соответствует перечислителю.

Remarks

Если метод выполнен успешно, массив, заданный ppMediaTypes , содержит указатели на AM_MEDIA_TYPE структуры. Число структур равно *pcFetched. Освободите каждый тип мультимедиа, вызвав функцию DeleteMediaType.

Этот метод вызывает метод CBasePin::GetMediaType пин-кода для получения типов мультимедиа.

Требования

Требование Значение
Заголовок
Amfilter.h (include Потоки.h)
Библиотека
Strmbase.lib (розничные сборки);
Strmbasd.lib (отладочные сборки)

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

Класс CEnumMediaTypes