Метод IMFSourceReader::SetStreamSelection (mfreadwrite.h)

Выбирает или отменяет выбор одного или нескольких потоков.

Синтаксис

HRESULT SetStreamSelection(
  [in] DWORD dwStreamIndex,
  [in] BOOL  fSelected
);

Параметры

[in] dwStreamIndex

Поток, который нужно задать. Значение может быть любым из следующих значений.

Ценность	Meaning
0–0xFFFFFFFB	Отсчитываемый от нуля индекс потока.
MF_SOURCE_READER_FIRST_VIDEO_STREAM 0xFFFFFFFC	Первый видеопоток.
MF_SOURCE_READER_FIRST_AUDIO_STREAM 0xFFFFFFFD	Первый аудиопоток.
MF_SOURCE_READER_ALL_STREAMS 0xFFFFFFFE	Все потоки.

[in] fSelected

Укажите ЗНАЧЕНИЕ TRUE , чтобы выбрать потоки или FALSE для отмены выбора потоков. Если поток не выбран, он не создаст данные.

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

Если этот метод выполнен успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT.

Замечания

Для этого метода используется два распространенных метода:

• Чтобы изменить выбор потока по умолчанию. Некоторые файлы мультимедиа содержат несколько потоков одного типа. Например, файл может включать аудиопотоки для нескольких языков. Этот метод можно использовать для изменения выбранного потока. Чтобы получить сведения о каждом потоке, вызовите МВФSourceReader::GetPresentationAttribute или IMFSourceReader::GetNativeMediaType.
• Если вам не потребуются данные из одного из потоков, рекомендуется отменить выбор этого потока. Если выбран поток, источник мультимедиа может удерживать очередь непрочитанных данных, и очередь может увеличиваться на неопределенный срок, потребляя память.

Пример отмены выбора потока см. в руководстве по декодированию звука.

Если поток не выбран, метод IMFSourceReader::ReadSample возвращает MF_E_INVALIDREQUEST для этого потока. Другие методы МВФSourceReader допустимы для деизбираемых потоков.

Выбор потока не влияет на загрузку или выгрузку декодеров в памяти. В частности, отмена выбора потока не заставляет средства чтения источника выгрузить декодировщик для этого потока.

Этот интерфейс доступен в Windows Vista, если установлено дополнение к обновлению платформы для Windows Vista.

Требования

Требование	Ценность
Минимальный поддерживаемый клиент	Дополнение к Обновлению Windows 7, Windows Vista и платформы для Windows Vista [классические приложения | Приложения UWP]
минимальный поддерживаемый сервер	Windows Server 2008 R2 [классические приложения | Приложения UWP]
целевая платформа	Виндоус
Header	mfreadwrite.h

См. также

МВФSourceReader

Средство чтения источника