?? msgs_1xid.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>LINE_CALLSTATE</TITLE>
<SCRIPT SRC="/library/psdk/linkcss.js"></SCRIPT>
<META NAME="MS-HKWD" CONTENT="LINE_CALLSTATE">
<META NAME="MS-HAID" CONTENT="_tapi2_line_callstate">
</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_callstate"></A>LINE_CALLSTATE</H1>
<P>The TAPI LINE_CALLSTATE message is sent when the status of the specified call has changed. Typically, several such messages are received during the lifetime of a call. Applications are notified of new incoming calls with this message; the new call is in the <I>offering</I> state. The application can use <A HREF="func1_7iur.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func1_7iur.htm"><B>lineGetCallStatus</B></A> to retrieve more detailed information about the current status of the call. </P>
<PRE class=syntax>LINE_CALLSTATE
hDevice = (DWORD) hCall;
dwCallbackInstance = (DWORD) hCallback;
dwParam1 = (DWORD) CallState;
dwParam2 = (DWORD) CallStateDetail;
dwParam3 = (DWORD) CallPrivilege;</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 call's line. </DD>
<DT><I>dwParam1</I> </DT>
<DD>The new call state. This parameter must be one and only one of the following <A HREF="constnts_6t0z.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/constnts_6t0z.htm">LINECALLSTATE_ constants</A>.</DD>
<DT><I>dwParam2</I> </DT>
<DD>Call-state-dependent information.
<TABLE>
<TR VALIGN="top">
<TH align=left width=48%>dwParam1</TH>
<TH align=left width=52%>dwParam2</TH>
</TR>
<TR VALIGN="top">
<TD width=48%>If <I>dwParam1</I> is LINECALLSTATE_BUSY,</TD>
<TD width=52%><I>dwParam2</I> contains details about the busy mode. This parameter uses one of the <A HREF="constnts_4q5v.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/constnts_4q5v.htm">LINEBUSYMODE_ constants</A>.</TD>
</TR>
<TR VALIGN="top">
<TD width=48%>If <I>dwParam1</I> is LINECALLSTATE_CONNECTED,</TD>
<TD width=52%><I>dwParam2</I> contains details about the connected mode. This parameter uses one of the <A HREF="constnts_8m7n.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/constnts_8m7n.htm">LINECONNECTEDMODE_ constants</A>.</TD>
</TR>
<TR VALIGN="top">
<TD width=48%>If <I>dwParam1</I> is LINECALLSTATE_DIALTONE, </TD>
<TD width=52%><I>dwParam2</I> contains details about the dial tone mode. This parameter uses one of the <A HREF="constnts_2dbn.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/constnts_2dbn.htm">LINEDIALTONEMODE_ constants</A>.</TD>
</TR>
<TR VALIGN="top">
<TD width=48%>If <I>dwParam1</I> is LINECALLSTATE_OFFERING, </TD>
<TD width=52%><I>dwParam2</I> contains details about the connected mode. This parameter uses one of the <A HREF="constnts_0zjn.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/constnts_0zjn.htm">LINEOFFERINGMODE_ constants</A>.</TD>
</TR>
<TR VALIGN="top">
<TD width=48%>If <I>dwParam1</I> is LINECALLSTATE_SPECIALINFO,</TD>
<TD width=52%><I>dwParam2</I> contains the details about the special information mode. This parameter uses one of the <A HREF="constnts_812r.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/constnts_812r.htm">LINESPECIALINFO_ constants</A>.</TD>
</TR>
<TR VALIGN="top">
<TD width=48%>If <I>dwParam1</I> is LINECALLSTATE_DISCONNECTED, </TD>
<TD width=52%><I>dwParam2</I> contains details about the disconnect mode. This parameter uses one of the <A HREF="constnts_90j7.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/constnts_90j7.htm">LINEDISCONNECTMODE_ constants</A>.</TD>
</TR>
</TABLE><BR>
<P class=note><B>Note</B> In circumstances where a <I>delayed</I> response is appropriate, use LINEDISCONNECTMODE_TEMPFAILURE. Where a <I>blacklisted</I> response is appropriate, use LINEDISCONNECT_BLOCKED. For further information, see <A HREF="constnts_90j7.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/constnts_90j7.htm">LINEDISCONNECTMODE_ Constants</A>.
<P>If <I>dwParam1</I> is LINECALLSTATE_CONFERENCED, <I>dwParam2</I> contains the <I>hConfCall</I> parameter of the parent call of the conference of which the subject <I>hCall</I> is a member. If the call specified in <I>dwParam2</I> was not previously considered by the application to be a parent conference call (<I>hConfCall)</I>, the application must do so as a result of this message. If the application does not have a handle to the parent call of the conference (because it has previously called <A HREF="func1_3wto.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func1_3wto.htm"><B>lineDeallocateCall</B></A> on that handle) <I>dwParam2</I> is set to NULL.
</DD>
<DT><I>dwParam3</I> </DT>
<DD>If zero, this parameter indicates that there has been no change in the application's privilege for the call.
<P>If nonzero, it specifies the application's privilege for the call. This occurs in the following situations: (1) The first time that the application is given a handle to this call; (2) When the application is the target of a call handoff (even if the application already was an owner of the call). This parameter uses one of the following <A HREF="constnts_4777.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/constnts_4777.htm">LINECALLPRIVILEGE_ constants</A>.
</DD>
</DL>
<H4>Return Values</H4>
<P>No return value. </P>
<H4>Remarks</H4>
<P>This message is sent to any application that has a handle for the call. The LINE_CALLSTATE message also notifies applications that monitor calls on a line about the existence and state of outbound calls established by other applications or manually by the user (for example, on an attached phone device). The call state of such calls reflects the actual state of the call, which is not <I>offering</I>. By examining the call state, the application can determine whether the call is an inbound call that needs to be answered or not. </P>
<P>A LINE_CALLSTATE message with an unknown call state can be sent to a monitoring application as the result of a successful <A HREF="func1_7mgc.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func1_7mgc.htm"><B>lineMakeCall</B></A>, <A HREF="func1_36jo.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func1_36jo.htm"><B>lineForward</B></A>, <A HREF="func2_6ktn.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func2_6ktn.htm"><B>lineUnpark</B></A>, <A HREF="func2_8ofm.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func2_8ofm.htm"><B>lineSetupTransfer</B></A>, <A HREF="func2_6do0.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func2_6do0.htm"><B>linePickup</B></A>, <A HREF="func2_7z8l.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func2_7z8l.htm"><B>lineSetupConference</B></A>, or <A HREF="func2_8e1x.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func2_8e1x.htm"><B>linePrepareAddToConference</B></A> that has been requested by another application. At the same time that the requesting application is sent a <A HREF="msgs_65mh.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/msgs_65mh.htm">LINE_REPLY</A> (success) for the requested operation, any monitoring applications on the line are sent the LINE_CALLSTATE (unknown) message. A LINE_CALLSTATE message indicating the "real" call state of the newly generated call is sent (using information provided by the service provider) to the requesting and monitoring applications shortly thereafter. </P>
<P>A LINE_CALLSTATE (unknown) message is sent to monitoring applications only if <A HREF="func1_9b1u.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func1_9b1u.htm"><B>lineCompleteTransfer</B></A> causes calls to be resolved into a three-way conference. </P>
<P>For backward compatibility, older applications are not expecting any particular value in <I>dwParam2</I> of a LINECALLSTATE_CONFERENCED message. TAPI therefore passes the parent call <I>hConfCall</I> in <I>dwParam2</I> regardless of the API version of the application receiving the message. In the case of a conference call initiated by the service provider, the older application is not aware that the parent call has become a conference call unless it happens to spontaneously examine other information (for example, call <A HREF="func1_5qlv.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func1_5qlv.htm"><B>lineGetConfRelatedCalls</B></A>). </P>
<P>This message cannot be disabled. </P>
<H4><A HREF="javascript:if(confirm('http://msdn.microsoft.com/library/psdk/sdkintro/guide_927n.htm \n\n這個(gè)文件不能通過 Teleport Pro 取回, 因?yàn)?地址在一個(gè)域或?yàn)樗拈_始地址設(shè)定的邊界的外部路徑上. \n\n你想從服務(wù)器打開它嗎?'))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_65mh.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/msgs_65mh.htm">LINE_REPLY</A>, <A HREF="func1_9b1u.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func1_9b1u.htm"><B>lineCompleteTransfer</B></A>, <A HREF="func1_3wto.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func1_3wto.htm"><B>lineDeallocateCall</B></A>, <A HREF="struc2_30xe.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/struc2_30xe.htm"><B>LINEDIALPARAMS</B></A>, <A HREF="func1_36jo.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func1_36jo.htm"><B>lineForward</B></A>, <A HREF="func1_8ir7.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func1_8ir7.htm"><B>lineGenerateDigits</B></A>, <A HREF="func1_7iur.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func1_7iur.htm"><B>lineGetCallStatus</B></A>, <A HREF="func1_5qlv.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func1_5qlv.htm"><B>lineGetConfRelatedCalls</B></A>, <A HREF="func1_7mgc.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func1_7mgc.htm"><B>lineMakeCall</B></A>, <A HREF="func2_6do0.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func2_6do0.htm"><B>linePickup</B></A>, <A HREF="func2_8e1x.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func2_8e1x.htm"><B>linePrepareAddToConference</B></A>, <A HREF="func2_8ofm.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func2_8ofm.htm"><B>lineSetupTransfer</B></A>, <A HREF="func2_6ktn.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func2_6ktn.htm"><B>lineUnpark</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è)文件不能通過 Teleport Pro 取回, 因?yàn)?地址在一個(gè)域或?yàn)樗拈_始地址設(shè)定的邊界的外部路徑上. \n\n你想從服務(wù)器打開它嗎?'))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>
?? 快捷鍵說明
復(fù)制代碼
Ctrl + C
搜索代碼
Ctrl + F
全屏模式
F11
切換主題
Ctrl + Shift + D
顯示快捷鍵
?
增大字號(hào)
Ctrl + =
減小字號(hào)
Ctrl + -