Метод IAMStreamSelect::Info (strmif.h)

Статья
03/05/2024

[Функция, связанная с этой страницей DirectShow, является устаревшей функцией. Он был заменен MediaPlayer, IMFMediaEngine, и аудио/ видео захвата в Media Foundation. Эти функции оптимизированы для Windows 10 и Windows 11. Корпорация Майкрософт настоятельно рекомендует использовать в новом коде MediaPlayer, IMFMediaEngine и аудио/видеозахват в Media Foundation вместо DirectShow, когда это возможно. Корпорация Майкрософт предлагает переписать существующий код, в котором используются устаревшие API, чтобы по возможности использовать новые API.]

Метод Info извлекает сведения о заданном потоке.

Синтаксис

HRESULT Info(
  [in]  long          lIndex,
  [out] AM_MEDIA_TYPE **ppmt,
  [out] DWORD         *pdwFlags,
  [out] LCID          *plcid,
  [out] DWORD         *pdwGroup,
  [out] LPWSTR        *ppszName,
  [out] IUnknown      **ppObject,
  [out] IUnknown      **ppUnk
);

Параметры

[in] lIndex

Отсчитываемый от нуля индекс потока.

[out] ppmt

Адрес переменной, которая получает указатель на тип мультимедиа потока. Этот параметр является необязательным и может иметь значение NULL. Если значение не равно NULL, метод возвращает указатель на структуру AM_MEDIA_TYPE . Вызывающий объект должен удалить структуру, включая блок формата. (Вы можете использовать функцию DeleteMediaType из библиотеки базового класса DirectShow.)

[out] pdwFlags

Указатель на переменную, которая получает одно из следующих значений:

Значение	Описание
Ноль	Этот поток отключен.
AMSTREAMSELECTINFO_ENABLED	Поток включен, и другие пользователи этой группы также могут быть включены.
AMSTREAMSELECTINFO_EXCLUSIVE	Этот поток является единственным включенным потоком в группе.

Этот параметр является необязательным и может иметь значение NULL.

[out] plcid

Указатель на переменную, которая получает значение контекста языкового стандарта (LCID). Если поток связан с определенным языковым стандартом, код языка возвращается в этой переменной. В противном случае переменная получает нулевое значение. Этот параметр является необязательным и может иметь значение NULL.

[out] pdwGroup

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

[out] ppszName

Адрес переменной, получающей указатель на имя потока. Вызывающий объект должен освободить возвращенную строку, вызвав функцию CoTaskMemFree . Этот параметр является необязательным и может иметь значение NULL.

[out] ppObject

Адрес переменной, получающей указатель интерфейса IUnknown . Метод может возвращать указатель на контакт или фильтр, связанный с потоком, или возвращать значение NULL. Если метод возвращает значение, отличное от NULL , вызывающий объект должен освободить указатель IUnknown .

Вызов метода IAMStreamSelect::Enable может сделать недействительным объект, возвращенный этим методом.

Этот параметр является необязательным и может иметь значение NULL.

Фильтры средства синтаксического анализа MPEG-1 Stream Splitter, MPEG-2 Splitter и SAMI (CC) возвращают указатель на контакт, связанный с выбранным потоком.

[out] ppUnk

Адрес переменной, получающей указатель интерфейса IUnknown . Метод может возвращать указатель на интерфейс, относящееся к потоку, или возвращать значение NULL. Если метод возвращает значение, отличное от NULL , вызывающий объект должен освободить указатель IUnknown . Этот параметр является необязательным и может иметь значение NULL.

Все фильтры анализатора MPEG-1 Stream Splitter, MPEG-2 Splitter и SAMI (CC) возвращают значение NULL. Сторонние фильтры могут возвращать указатель на пользовательский интерфейс фильтра.

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

Возвращает значение HRESULT . Ниже приведены возможные значения.

Код возврата	Описание
E_FAIL	Ошибка.
E_OUTOFMEMORY	Недостаточно памяти.
S_FALSE	Данный индекс вне пределов диапазона.
S_OK	Успешно.

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	strmif.h (включая Dshow.h)
Библиотека	Strmiids.lib

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

Коды ошибок и успешности

Интерфейс IAMStreamSelect

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