lineSetMediaMode function (tapi.h)

The lineSetMediaMode function sets the media type(s) of the specified call in its LINECALLINFO structure. For more information, see ITLegacyCallMediaControl::SetMediaType.

Syntax

LONG lineSetMediaMode(
  HCALL hCall,
  DWORD dwMediaModes
);

Parameters

hCall

Handle to the call whose media type is to be changed. The application must be an owner of the call. The call state of hCall can be any state.

dwMediaModes

New media type(s) for the call. This parameter uses the LINEMEDIAMODE_ Constants. As long as the UNKNOWN media type flag is set, other media type flags may be set as well. This is used to identify a call's media type as not fully determined, but narrowed down to one of a small set of specified media types. If the UNKNOWN flag is not set, only a single media type can be specified.

Return value

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 type in its LINECALLINFO structure. Typical usage of this operation is either to set a call's media type to a specific known media type or to exclude possible media types as long as the call's media type is officially unknown (the UNKNOWN media type flag is set).

Requirements

   
Target Platform Windows
Header tapi.h
Library Tapi32.lib
DLL Tapi32.dll

See also

LINECALLINFO

Supplementary Line Service Functions

TAPI 2.2 Reference Overview