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

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

Синтаксис

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. Допустимые значения включают, но не ограничиваются, значения, приведенные в следующей таблице.

Комментарии

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

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

Требования

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

Профиль ASF

IMFASFProfile

IMFASFProfile::GetStreamByNumber

IMFASFProfile::GetStreamCount

IMFASFProfile::RemoveStream

IMFASFProfile::SetStream

IMFASFStreamConfig