ITBasicCallControl2::RequestTerminal method (tapi3if.h)

The RequestTerminal method gets a suitable terminal, given the class, media, and direction required.

Syntax

HRESULT RequestTerminal(
  [in]  BSTR               bstrTerminalClassGUID,
  [in]  long               lMediaType,
  [in]  TERMINAL_DIRECTION Direction,
  [out] ITTerminal         **ppTerminal
);

Parameters

[in] bstrTerminalClassGUID

The terminal class required for the call.

[in] lMediaType

Bitwise ORed list of media types required for the call.

[in] Direction

The TERMINAL_DIRECTION descriptor for the terminal.

[out] ppTerminal

Pointer to ITTerminal interface.

Return value

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

The AddRef method is automatically called on the ITTerminal interface returned by this method. The application must call the Release method on the ITTerminal interface to free resources associated with it.

Requirements

See also

ITBasicCallControl2

ITTerminal