ITTerminalControl::ConnectTerminal method (termmgr.h)

The ConnectTerminal method connects filters and returns a set of pins for connection. Enters each of the internal filters into the filter graph, connects the internal filters together (if applicable) and returns a set of pins for connection.

Syntax

HRESULT ConnectTerminal(
  [in]      IGraphBuilder *pGraph,
  [in]      DWORD         dwTerminalDirection,
  [in, out] DWORD         *pdwNumPins,
  [out]     IPin          **ppPins
);

Parameters

[in] pGraph

Pointer to graph builder interface.

[in] dwTerminalDirection

Indicator of terminal direction.

[in, out] pdwNumPins

Pointer to number of pins.

[out] ppPins

Pointer to array of pins to be used for media transport related to the current terminal.

Return value

This method can return one of these values.

Value	Meaning
S_OK	Method succeeded.
TAPI_E_NOTENOUGHMEMORY	Insufficient memory exists to perform the operation.
TAPI_E_TERMINALINUSE	The current terminal is already in use.

Requirements

Requirement	Value
Target Platform	Windows
Header	termmgr.h

See also

ITTerminalControl