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