Share via

Метод IMFTopologyNode::ConnectOutput (mfidl.h)

  • Статья

Подключает поток вывода из этого узла к входному потоку другого узла.

Синтаксис

HRESULT ConnectOutput(
  [in] DWORD           dwOutputIndex,
  [in] IMFTopologyNode *pDownstreamNode,
  [in] DWORD           dwInputIndexOnDownstreamNode
);

Параметры

[in] dwOutputIndex

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

[in] pDownstreamNode

Указатель на интерфейс IMFTopologyNode узла, к которому нужно подключиться.

[in] dwInputIndexOnDownstreamNode

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

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

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

Код возврата Описание
S_OK
 Метод выполнен успешно.
E_FAIL
 Сбой метода.
E_INVALIDARG
 Недопустимый параметр.

Комментарии

Подключения узлов представляют поток данных от одного узла к другому. Потоки являются логическими и задаются индексом.

Если узел уже подключен на указанных выходных данных, метод разрывает существующее соединение. Если dwOutputIndex или dwInputIndexOnDownstreamNode указывают потоки, которые еще не существуют, метод добавляет столько потоков, сколько необходимо.

Этот метод проверяет наличие некоторых недопустимых условий:

  • Выходной узел не может иметь выходных подключений. При вызове этого метода на выходном узле метод возвращает E_FAIL.
  • Узел не может быть подключен к самому себе. Если pDownstreamNode указывает тот же узел, что и вызов метода, метод возвращает E_INVALIDARG.
Однако если метод выполняется успешно, это не гарантирует допустимость подключения к узлу. Можно создать частичную топологию, которую загрузчик топологии не может разрешить. В этом случае метод IMFTopoLoader::Load завершится ошибкой.

Чтобы разорвать существующее подключение к узлу, вызовите IMFTopologyNode::D isconnectOutput.

Требования

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

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

IMFTopologyNode

Топологии