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

Метод IMFMediaSink::RemoveStreamSink (mfidl.h)

  • Статья

Удаляет приемник потока из приемника мультимедиа.

Синтаксис

HRESULT RemoveStreamSink(
  [in] DWORD dwStreamSinkIdentifier
);

Параметры

[in] dwStreamSinkIdentifier

Идентификатор удаляемого потока. Идентификатор потока определяется при вызове IMFMediaSink::AddStreamSink для добавления приемника потока.

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

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

Код возврата Описание
S_OK
 Метод выполнен успешно.
E_INVALIDARG
 Этот конкретный приемник потока нельзя удалить.
MF_E_INVALIDSTREAMNUMBER
 Недопустимый номер потока.
MF_E_NOT_INITIALIZED
 Приемник мультимедиа не инициализирован.
MF_E_SHUTDOWN
 Был вызван метод Shutdown приемника мультимедиа.
MF_E_STREAMSINKS_FIXED
 Этот приемник мультимедиа имеет фиксированный набор потоковых приемников. Stream приемники не могут быть удалены.

Комментарии

После вызова этого метода соответствующий объект приемника потока становится недействительным. Методы IMFMediaSink::GetStreamSinkByIndex и IMFMediaSink::GetStreamSinkById больше не будут возвращать этот приемник потока. Идентификатор потока можно повторно использовать при добавлении другого потока (путем вызова Метода AddStreamSink).

Не все приемники мультимедиа поддерживают этот метод. Если приемник мультимедиа не поддерживает этот метод, метод IMFMediaSink::GetCharacteristics возвращает флаг MEDIASINK_FIXED_STREAMS.

В некоторых случаях приемник мультимедиа поддерживает этот метод, но не позволяет удалять все приемники потоков. (Например, это может не разрешить удаление потока 0.)

Требования

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

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

IMFMediaSink

Приемники мультимедиа