?? func1_8ir7.htm
字號(hào):
<!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>lineGenerateDigits</TITLE>
<SCRIPT SRC="/library/psdk/linkcss.js"></SCRIPT>
<META NAME="MS-HKWD" CONTENT="lineGenerateDigits">
<META NAME="MS-HAID" CONTENT="_tapi2_linegeneratedigits">
</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_linegeneratedigits"></A>lineGenerateDigits</H1>
<P>The <B>lineGenerateDigits</B> function initiates the generation of the specified digits on the specified call as inband tones using the specified signaling mode. Invoking this function with a NULL value for <I>lpszDigits</I> aborts any digit generation currently in progress. Invoking <B>lineGenerateDigits</B> or <A HREF="func1_23xh.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func1_23xh.htm"><B>lineGenerateTone</B></A> while digit generation is in progress aborts the current digit generation or tone generation and initiates the generation of the most recently specified digits or tone. </P>
<PRE class=syntax><B>LONG WINAPI lineGenerateDigits(
HCALL</B><I> hCall</I><B>, </B>
<B> DWORD</B><I> dwDigitMode</I><B>, </B>
<B> LPCSTR</B><I> lpszDigits</I><B>, </B>
<B> DWORD</B><I> dwDuration </I>
<B>);</B></PRE>
<H4>Parameters</H4>
<DL>
<DT><I>hCall</I> </DT>
<DD>A handle to the call. The application must be an owner of the call. Call state of <I>hCall</I> can be any state. </DD>
<DT><I>dwDigitMode</I> </DT>
<DD>The format to be used for signaling these digits. Note that <I>dwDigitMode</I> is allowed to have only a single flag set. This parameter uses one of the <A HREF="constnts_56gj.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/constnts_56gj.htm">LINEDIGITMODE_ Constants</A>.</DD>
<DT><I>lpszDigits</I> </DT>
<DD>A pointer to a null-terminated character buffer that contains the digits to be generated. Valid characters are those specified for the <A HREF="constnts_56gj.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/constnts_56gj.htm">LINEDIGITMODE_ Constants</A> provided in <I>dwDigitModes</I>.
<P>In addition, ',' (comma) is also a valid character. A comma injects an extra delay between the signaling of the previous and next digits it separates. The duration of this pause is configuration defined, and the line's device capabilities indicate what this duration is. Multiple commas can be used to inject longer pauses. Invalid digits are ignored during the generation, rather than being reported as errors.
<P>'!' (exclamation) is a valid character. This character causes a "hookflash" operation, as described for <A HREF="javascript:if(confirm('http://msdn.microsoft.com/library/psdk/tapi3/tapiovr2_3ib6.htm \n\n這個(gè)文件不能通過(guò) Teleport Pro 取回, 因?yàn)?地址在一個(gè)域或?yàn)樗拈_(kāi)始地址設(shè)定的邊界的外部路徑上. \n\n你想從服務(wù)器打開(kāi)它嗎?'))window.location='http://msdn.microsoft.com/library/psdk/tapi3/tapiovr2_3ib6.htm#_tapi3_dialable_addresses'" tppabs="http://msdn.microsoft.com/library/psdk/tapi3/tapiovr2_3ib6.htm#_tapi3_dialable_addresses">dialable addresses</A>.
</DD>
<DT><I>dwDuration</I> </DT>
<DD>Both the duration in milliseconds of DTMF digits and pulse and DTMF inter-digit spacing. A value of 0 uses a default value. The <I>dwDuration</I> parameter must be within the range specified by <B>MinDialParams</B> and <B>MaxDialParams</B> in <A HREF="struc2_67aq.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/struc2_67aq.htm"><B>LINEDEVCAPS</B></A>. If out of range, the actual value is set to the nearest value in the range.
</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_NOTOWNER, LINEERR_INVALCALLSTATE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALDIGITMODE, LINEERR_OPERATIONFAILED, LINEERR_INVALPOINTER, LINEERR_RESOURCEUNAVAIL, LINEERR_NOMEM, LINEERR_UNINITIALIZED.</P>
<H4>Remarks</H4>
<P>The <B>lineGenerateDigits</B> function is considered to have completed successfully when the digit generation has been successfully initiated, not when all digits have been generated. In contrast to <A HREF="func1_0p0s.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func1_0p0s.htm"><B>lineDial</B></A>, which dials digits in a network-dependent fashion, <B>lineGenerateDigits</B> guarantees to produce the digits as inband tones over the voice channel using DTMF or hookswitch dial pulses when using pulse. The <B>lineGenerateDigits</B> function is generally not suitable for making calls or dialing. It is intended for end-to-end signaling over an established call. </P>
<P>After all digits in <I>lpszDigits</I> have been generated, or after digit generation has been aborted or canceled, a <A HREF="msgs_0hnp.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/msgs_0hnp.htm">LINE_GENERATE</A> message is sent to the application. </P>
<P>Only one inband generation request (tone generation or digit generation) is allowed to be in progress per call across all applications that are owners of the call. Digit generation on a call is canceled by initiating either another digit generation request or a tone generation request. To cancel the current digit generation, the application can invoke <B>lineGenerateDigits</B> and specify NULL for the <I>lpszDigits</I> parameter. </P>
<P>Depending on the service provider and hardware, the application can monitor the digits it generates itself. If that is not desired, the application can disable digit monitoring while generating digits. </P>
<H4><A HREF="javascript:if(confirm('http://msdn.microsoft.com/library/psdk/sdkintro/guide_927n.htm \n\n這個(gè)文件不能通過(guò) Teleport Pro 取回, 因?yàn)?地址在一個(gè)域或?yàn)樗拈_(kāi)始地址設(shè)定的邊界的外部路徑上. \n\n你想從服務(wù)器打開(kāi)它嗎?'))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.<BR>
<B> Unicode: </B>Implemented as Unicode and ANSI versions on all platforms.</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="msgs_0hnp.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/msgs_0hnp.htm">LINE_GENERATE</A>, <A HREF="struc2_67aq.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/struc2_67aq.htm"><B>LINEDEVCAPS</B></A>, <A HREF="func1_0p0s.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func1_0p0s.htm"><B>lineDial</B></A>, <A HREF="func1_23xh.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func1_23xh.htm"><B>lineGenerateTone</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這個(gè)文件不能通過(guò) Teleport Pro 取回, 因?yàn)?地址在一個(gè)域或?yàn)樗拈_(kāi)始地址設(shè)定的邊界的外部路徑上. \n\n你想從服務(wù)器打開(kāi)它嗎?'))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>
?? 快捷鍵說(shuō)明
復(fù)制代碼
Ctrl + C
搜索代碼
Ctrl + F
全屏模式
F11
切換主題
Ctrl + Shift + D
顯示快捷鍵
?
增大字號(hào)
Ctrl + =
減小字號(hào)
Ctrl + -