Partager via


lineSetMediaMode (Windows Embedded CE 6.0)

1/6/2010

This function sets the media types of the specified call in its LINECALLINFO structure.

Syntax

LONG WINAPI 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 types 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. The following table shows the return values for this function.

Value Description

LINEERR_INVALCALLHANDLE

The handle to the call is invalid.

LINEERR_OPERATIONFAILED

The operation failed.

LINEERR_INVALMEDIAMODE

The media mode is invalid.

LINEERR_RESOURCEUNAVAIL

The resources are unavailable.

LINEERR_NOMEM

Not enough memory is available.

LINEERR_UNINITIALIZED

A parameter is uninitialized.

LINEERR_OPERATIONUNAVAIL

The operation is unavailable.

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).

Note

This function is for TAPI version 2.0 and later.

Requirements

Header tapi.h
Library coredll.lib
Windows Embedded CE Windows CE 1.0 and later

See Also

Reference

LINECALLINFO

Concepts

TAPI Line Device Functions