lineSetMediaMode

The lineSetMediaMode function sets the media mode(s) of the specified call in its LINECALLINFO structure.

LONG lineSetMediaMode(
  HCALL hCall,        
  DWORD dwMediaModes  
);
 

Parameters

hCall
A handle to the call whose media mode is to be changed. The application must be an owner of the call. The call state of hCall can be any state.
dwMediaModes
The new media mode(s) for the call. As long as the UNKNOWN media mode flag is set, other media mode flags may be set as well. This is used to identify a call's media mode as not fully determined, but narrowed down to one of a small set of specified media modes. If the UNKNOWN flag is not set, only a single media mode can be specified. This parameter uses the following LINEMEDIAMODE_ constants:
LINEMEDIAMODE_UNKNOWN
The target application is the one that handles calls of unknown media mode (unclassified calls).
LINEMEDIAMODE_INTERACTIVEVOICE
The target application is the one that handles calls with the interactive voice media mode (live conversations).
LINEMEDIAMODE_AUTOMATEDVOICE
Voice energy is present on the call, and the voice is locally handled by an automated application.
LINEMEDIAMODE_DATAMODEM
The target application is the one that handles calls with the data modem media mode.
LINEMEDIAMODE_G3FAX
The target application is the one that handles calls with the group 3 fax media mode.
LINEMEDIAMODE_TDD
The target application is the one that handles calls with the TDD (Telephony Devices for the Deaf) media mode.
LINEMEDIAMODE_G4FAX
The target application is the one that handles calls with the group 4 fax media mode.
LINEMEDIAMODE_DIGITALDATA
The target application is the one that handles calls that are digital data calls.
LINEMEDIAMODE_TELETEX
The target application is the one that handles calls with the teletex media mode.
LINEMEDIAMODE_VIDEOTEX
The target application is the one that handles calls with the videotex media mode.
LINEMEDIAMODE_TELEX
The target application is the one that handles calls with the telex media mode.
LINEMEDIAMODE_MIXED
The target application is the one that handles calls with the ISDN mixed media mode.
LINEMEDIAMODE_ADSI
The target application is the one that handles calls with the ADSI (Analog Display Services Interface) media mode.
LINEMEDIAMODE_VOICEVIEW
The media mode of the call is VoiceView.

Return Values

Returns zero if the request succeeds or a negative error number if an error occurs. Possible return values are:

LINEERR_INVALCALLHANDLE, LINEERR_OPERATIONFAILED, LINEERR_INVALMEDIAMODE, LINEERR_RESOURCEUNAVAIL, LINEERR_NOMEM, LINEERR_UNINITIALIZED, LINEERR_OPERATIONUNAVAIL.

Remarks

The lineSetMediaMode function changes the call's media mode in its LINECALLINFO structure. Typical usage of this operation is either to set a call's media mode to a specific known media mode or to exclude possible media modes as long as the call's media mode is officially unknown (the UNKNOWN media mode flag is set).

QuickInfo

  Version: Use TAPI version 1.4 and later.
  Header: Declared in tapi.h.
  Import Library: Link with tapi32.lib.

See Also

TAPI Reference Overview, Supplementary Line Services Functions, LINECALLINFO