?? msgs_65mb.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>LINE_GATHERDIGITS</TITLE>
<SCRIPT SRC="/library/psdk/linkcss.js"></SCRIPT>
<META NAME="MS-HKWD" CONTENT="LINE_GATHERDIGITS">
<META NAME="MS-HAID" CONTENT="_tapi2_line_gatherdigits">
</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_line_gatherdigits"></A>LINE_GATHERDIGITS</H1>
<P>The TAPI LINE_GATHERDIGITS message is sent when the current buffered digit-gathering request has terminated or is canceled. The digit buffer can be examined after this message has been received by the application. </P>
<PRE class=syntax>LINE_GATHERDIGITS
hDevice = (DWORD) hCall;
dwCallbackInstance = (DWORD) hCallback;
dwParam1 = (DWORD) GatherTermination;
dwParam2 = (DWORD) 0;
dwParam3 = (DWORD) 0;</PRE>
<H4>Parameters</H4>
<DL>
<DT><I>hDevice</I> </DT>
<DD>A handle to the call. </DD>
<DT><I>dwCallbackInstance</I> </DT>
<DD>The callback instance supplied when opening the line. </DD>
<DT><I>dwParam1</I> </DT>
<DD>The reason why digit gathering was terminated. This parameter must be one and only one of the <A HREF="constnts_886r.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/constnts_886r.htm">LINEGATHERTERM_ constants</A>.</DD>
<DT><I>dwParam2</I> </DT>
<DD>Unused. </DD>
<DT><I>dwParam3</I> </DT>
<DD>The "tick count" (number of milliseconds since Windows started) at which the digit gathering completed. For TAPI versions earlier than 2.0, this parameter is unused.
</DD>
</DL>
<H4>Return Values</H4>
<P>No return value. </P>
<H4>Remarks</H4>
<P>The LINE_GATHERDIGITS message is only sent to the application that initiated the digit gathering on the call using <A HREF="func1_8q9f.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func1_8q9f.htm"><B>lineGatherDigits</B></A>. </P>
<P>If the <B>lineGatherDigits</B> function is used to cancel a previous request to gather digits, TAPI sends a LINE_GATHERDIGITS message with <I>dwParam1</I> set to LINEGATHERTERM_CANCEL to the application indicating that the originally specified buffer contains the digits gathered up to the cancellation. </P>
<P>Because the timestamp specified by <I>dwParam3</I> may have been generated on a computer other than the one on which the application is executing, it is useful only for comparison to other similarly timestamped messages generated on the same line device (<A HREF="msgs_0hnp.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/msgs_0hnp.htm">LINE_GENERATE</A>, <A HREF="msgs_5p0z.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/msgs_5p0z.htm">LINE_MONITORDIGITS</A>, <A HREF="msgs_0ext.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/msgs_0ext.htm">LINE_MONITORMEDIA</A>, <A HREF="msgs_8nz9.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/msgs_8nz9.htm">LINE_MONITORTONE</A>), in order to determine their <I>relative</I> timing (separation between events). The tick count can "wrap around" after approximately 49.7 days; applications must take this into account when performing calculations. </P>
<P>If the service provider does not generate the timestamp (for example, if it was created using an earlier version of TAPI), then TAPI provides a timestamp at the point closest to the service provider generating the event so that the synthesized timestamp is as accurate as possible. </P>
<P class=note><B>Note</B> When an application invokes any asynchronous operation that writes data back into application memory, the application must keep that memory available for writing until a <A HREF="msgs_65mh.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/msgs_65mh.htm">LINE_REPLY</A> or LINE_GATHERDIGITS message is received.</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 2.0 or later.<BR>
<B> Header: </B>Declared in Tapi.h.</P>
<H4>See Also</H4>
<P><A HREF="msgs_0hnp.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/msgs_0hnp.htm">LINE_GENERATE</A>, <A HREF="msgs_5p0z.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/msgs_5p0z.htm">LINE_MONITORDIGITS</A>, <A HREF="msgs_0ext.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/msgs_0ext.htm">LINE_MONITORMEDIA</A>, <A HREF="msgs_8nz9.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/msgs_8nz9.htm">LINE_MONITORTONE</A>, <A HREF="msgs_65mh.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/msgs_65mh.htm">LINE_REPLY</A>, <A HREF="func1_8q9f.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func1_8q9f.htm"><B>lineGatherDigits</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 + -