📄 func2_77eb.htm
字号:
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
<HTML DIR="LTR"><HEAD>
<META HTTP-EQUIV="Content-Type" CONTENT="text/html; CHARSET=iso8859-1">
</HEAD>
<TITLE>lineMonitorTones</TITLE>
<SCRIPT SRC="/library/psdk/linkcss.js"></SCRIPT>
<META NAME="MS-HKWD" CONTENT="lineMonitorTones">
<META NAME="MS-HAID" CONTENT="_tapi2_linemonitortones">
</HEAD>
<BODY TOPMARGIN="0">
<!--TOOLBAR_START-->
<!--TOOLBAR_EXEMPT-->
<!--TOOLBAR_END-->
<!--SYNC_START-->
<script language="JavaScript" src='/library/synch.js'></script>
<!--SYNC_END-->
<H1><A NAME="_tapi2_linemonitortones"></A>lineMonitorTones</H1>
<P>The <B>lineMonitorTones</B> function enables and disables the detection of inband tones on the call. Each time a specified tone is detected, a message is sent to the application. </P>
<PRE class=syntax><B>LONG WINAPI lineMonitorTones(
HCALL</B><I> hCall</I><B>, </B>
<B> LPLINEMONITORTONE const</B><I> lpToneList</I><B>, </B>
<B> DWORD</B><I> dwNumEntries </I>
<B>);</B></PRE>
<H4>Parameters</H4>
<DL>
<DT><I>hCall</I> </DT>
<DD>A handle to the call on whose voice channel tones are to be monitored. The call state of <I>hCall</I> can be any state except <I>idle</I>. </DD>
<DT><I>lpToneList</I> </DT>
<DD>A list of tones to be monitored, of type <A HREF="struc2_1xpu.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/struc2_1xpu.htm"><B>LINEMONITORTONE</B></A>. Each tone in this list has an application-defined tag field that is used to identify individual tones in the list to report a tone detection. Tone monitoring in progress is canceled or changed by calling this operation with either NULL for <I>lpToneList</I> or with another tone list. </DD>
<DT><I>dwNumEntries</I> </DT>
<DD>The number of entries in <I>lpToneList</I>. This parameter is ignored if <I>lpToneList</I> is NULL.
</DD>
</DL>
<H4>Return Values</H4>
<P>Returns zero if the request succeeds or a negative error number if an error occurs. Possible return values are: </P>
<P>LINEERR_INVALCALLHANDLE, LINEERR_INVALCALLSTATE, LINEERR_INVALPOINTER, LINEERR_INVALTONE, LINEERR_NOMEM, LINEERR_OPERATIONFAILED, LINEERR_OPERATIONUNAVAIL, LINEERR_RESOURCEUNAVAIL, LINEERR_UNINITIALIZED.</P>
<H4>Remarks</H4>
<P>This function succeeds if tone monitoring has been correctly initiated, not when tone monitoring has terminated. Tone monitoring remains in effect until it is explicitly disabled by calling <B>lineMonitorTones</B> with another tone list (or NULL), until the call transitions to <I>idle</I>, or when the application deallocates its call handle for the call. </P>
<P>Although this function can be invoked in any call state, tones can typically only be detected while the call is in the <I>connected</I> state. Tone detection typically requires computational resources. Depending on the service provider and other activities that compete for such resources, the number of tones that can be detected can vary over time. Also, an equivalent amount of resources can be consumed for monitoring a single triple frequency tone versus three single frequency tones. If resources are overcommitted, the LINEERR_RESOURCEUNAVAIL error is returned. </P>
<P>The <B>lineMonitorTones</B> function is also used to detect silence. Silence is specified as a tone with a frequency of zero. </P>
<P>Monitoring of tones on a conference call applies only to the <I>hConfCall</I>, not to the individual participating calls </P>
<P>If the LINEERR_INVALPOINTER error value is returned, the specified <I>lpToneList</I> parameter is invalid or the value specified by the <I>dwNumEntries</I> parameter is too large. </P>
<H4><A HREF="javascript:if(confirm('http://msdn.microsoft.com/library/psdk/sdkintro/guide_927n.htm \n\n这个文件不能通过 Teleport Pro 取回, 因为 地址在一个域或为它的开始地址设定的边界的外部路径上. \n\n你想从服务器打开它吗?'))window.location='http://msdn.microsoft.com/library/psdk/sdkintro/guide_927n.htm'" tppabs="http://msdn.microsoft.com/library/psdk/sdkintro/guide_927n.htm">Requirements</A> </H4>
<P><B> Windows NT/2000: </B>Requires Windows NT 4.0 SP3 or later.<BR>
<B> Windows 95/98: </B>Requires Windows 95 or later.<BR>
<B> Version: </B>Requires TAPI 1.3 or later.<BR>
<B> Header: </B>Declared in Tapi.h.<BR>
<B> Library: </B>Use Tapi32.lib.</P>
<H4>See Also</H4>
<P><A HREF="quickref_1okl.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/quickref_1okl.htm">TAPI 2.2 Reference Overview</A>, <A HREF="quickref_6gvn.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/quickref_6gvn.htm">Supplementary Line Service Functions</A>, <A HREF="struc2_1xpu.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/struc2_1xpu.htm"><B>LINEMONITORTONE</B></A></P>
<DIV CLASS="footer">Built on Monday, August 14, 2000</DIV>
<!--FOOTER_START-->
<DIV CLASS="footer" STYLE="color:#000000;font-size:90%;">
<A HREF="mailto:sdkfdbk@microsoft.com">Send feedback</A> to the Platform SDK.</P>
<P><A HREF="javascript:if(confirm('http://msdn.microsoft.com/isapi/gomscom.asp?TARGET=/info/cpyright.htm \n\n这个文件不能通过 Teleport Pro 取回, 因为 地址在一个域或为它的开始地址设定的边界的外部路径上. \n\n你想从服务器打开它吗?'))window.location='http://msdn.microsoft.com/isapi/gomscom.asp?TARGET=/info/cpyright.htm'" tppabs="http://msdn.microsoft.com/isapi/gomscom.asp?TARGET=/info/cpyright.htm" TARGET="_top">© 1999 Microsoft Corporation. All rights reserved. Terms of use.</A></P>
</DIV>
<!--FOOTER_END-->
</BODY>
</HTML>
⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -