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