lineSetMediaMode
The lineSetMediaMode function sets the media type(s) of the specified call in its LINECALLINFO structure.
LONG WINAPI lineSetMediaMode(
HCALL hCall,
DWORD dwMediaModes );
Parameters
- hCall
A 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
The 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 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 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
Runs On | Versions | Defined in | Include | Link to |
---|---|---|---|---|
Windows CE OS | 1.0 and later | Tapi.h | Coredll.lib |
Note This API is part of the complete Windows CE OS package as provided by Microsoft. The functionality of a particular platform is determined by the original equipment manufacturer (OEM) and some devices may not support this API.
See Also
Last updated on Tuesday, July 13, 2004
© 1992-2000 Microsoft Corporation. All rights reserved.