Метод IMFASFProfile::GetStream (wmcontainer.h)

Статья
08/28/2023

Извлекает поток из профиля по индексу потока и (или) получает номер потока для индекса потока.

Синтаксис

HRESULT GetStream(
  [in]  DWORD              dwStreamIndex,
  [out] WORD               *pwStreamNumber,
  [out] IMFASFStreamConfig **ppIStream
);

Параметры

[in] dwStreamIndex

Индекс извлекаемого потока. Stream индексы являются последовательными и отсчитываются от нуля. Количество потоков в профиле можно получить, вызвав метод IMFASFProfile::GetStreamCount .

[out] pwStreamNumber

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

[out] ppIStream

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

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

Метод возвращает HRESULT. Допустимые значения включают, но не ограничиваются, значения, приведенные в следующей таблице.

Код возврата	Описание
S_OK	Метод выполнен успешно.

Этот метод не создает копию объекта конфигурации потока. Извлекаемый указатель указывает на объект в объекте профиля. Не следует вносить какие-либо изменения в объект конфигурации потока с помощью этого указателя, так как это может повлиять на объект профиля непредвиденным образом.

Чтобы изменить конфигурацию объекта конфигурации потока в профиле, необходимо сначала клонировать объект конфигурации потока, вызвав IMFASFStreamConfig::Clone. Внесите необходимые изменения в клон объекта, а затем добавьте обновленный объект, вызвав метод IMFASFProfile::SetStream .

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista [только классические приложения]
Минимальная версия сервера	Windows Server 2008 [только классические приложения]
Целевая платформа	Windows
Header	wmcontainer.h
Библиотека	Mfuuid.lib