Platform SDK: TAPI

ITTerminalControl::ConnectTerminal

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.

HRESULT ConnectTerminal(
  IGraphBuilder *pGraph,
  DWORD dwReserved,
  DWORD *pdwNumPins,
  IPin **ppPins
);

Parameters

pGraph: [in] Pointer to graph builder interface.
dwReserved: [in] Reserved for future use.
pdwNumPins: [in,out] Pointer to number of pins.
ppPins: [out] Pointer to array of pins to be used for media transport related to the current terminal.

Return 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

  Windows NT/2000: Requires Windows 2000.
  Version: Requires TAPI 3.0 or later.
  Header: Declared in Termmgr.h.
  Library: Use T3iid.lib.

ITTerminalControl::ConnectTerminal

Parameters

Return Values

Requirements

See Also