?? 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 + -