?? msgs_402t.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_LINEDEVSTATE</TITLE>
<SCRIPT SRC="/library/psdk/linkcss.js"></SCRIPT>
<META NAME="MS-HKWD" CONTENT="LINE_LINEDEVSTATE">
<META NAME="MS-HAID" CONTENT="_tapi2_line_linedevstate">
</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_linedevstate"></A>LINE_LINEDEVSTATE</H1>
<P>The TAPI LINE_LINEDEVSTATE message is sent when the state of a line device has changed. The application can invoke <A HREF="func1_4377.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func1_4377.htm"><B>lineGetLineDevStatus</B></A> to determine the new status of the line. </P>
<PRE class=syntax>LINE_LINEDEVSTATE
hDevice = (DWORD) hLine;
dwCallbackInstance = (DWORD) hCallback;
dwParam1 = (DWORD) DeviceState;
dwParam2 = (DWORD) DeviceStateDetail1;
dwParam3 = (DWORD) DeviceStateDetail2;</PRE>
<H4>Parameters</H4>
<DL>
<DT><I>hDevice</I> </DT>
<DD>A handle to the line device. This parameter is NULL when <I>dwParam1</I> is LINEDEVSTATE_REINIT. </DD>
<DT><I>dwCallbackInstance</I> </DT>
<DD>The callback instance supplied when opening the line. If the <I>dwParam1</I> parameter is LINEDEVSTATE_REINIT, the <I>dwCallbackInstance</I> parameter is not valid and is set to zero. </DD>
<DT><I>dwParam1</I> </DT>
<DD>The line device status item that has changed. The parameter can be one or more of the <A HREF="constnts_0prn.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/constnts_0prn.htm">LINEDEVSTATE_ constants</A>.</DD>
<DT><I>dwParam2</I> </DT>
<DD>The interpretation of this parameter depends on the value of <I>dwParam1</I>. If <I>dwParam1</I> is LINEDEVSTATE_RINGING, <I>dwParam2</I> contains the ring mode with which the switch instructs the line to ring. Valid ring modes are numbers in the range one to <B>dwNumRingModes</B>, where <B>dwNumRingModes</B> is a line device capability.
<P>If <I>dwParam1</I> is LINEDEVSTATE_REINIT, and the message was issued by TAPI as a result of translation of a new API message into a REINIT message, then <I>dwParam2</I> contains the <I>dwMsg</I> parameter of the original message (for example, <A HREF="msgs_5qlh.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/msgs_5qlh.htm">LINE_CREATE</A> or LINE_LINEDEVSTATE). If <I>dwParam2</I> is zero, this indicates that the REINIT message is a "real" REINIT message that requires the application to call <A HREF="func2_7sq6.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func2_7sq6.htm"><B>lineShutdown</B></A> at its earliest convenience.
</DD>
<DT><I>dwParam3</I> </DT>
<DD>The interpretation of this parameter depends on the value of <I>dwParam1</I>. If <I>dwParam1</I> is LINEDEVSTATE_RINGING, <I>dwParam3</I> contains the ring count for this ring event. The ring count starts at zero.
<P>If <I>dwParam1</I> is LINEDEVSTATE_REINIT, and the message was issued by TAPI as a result of translation of a new API message into a REINIT message, then <I>dwParam3</I> contains the <I>dwParam1</I> parameter of the original message (for example, LINEDEVSTATE_TRANSLATECHANGE or some other LINEDEVSTATE_ value, if <I>dwParam2</I> is<I> </I>LINE_LINEDEVSTATE, or the new device identifier, if <I>dwParam2</I> is <A HREF="msgs_5qlh.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/msgs_5qlh.htm">LINE_CREATE</A>).
</DD>
</DL>
<H4>Return Values</H4>
<P>No return value. </P>
<H4>Remarks</H4>
<P>The sending of the LINE_LINEDEVSTATE message can be controlled with <A HREF="func2_3upf.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func2_3upf.htm"><B>lineSetStatusMessages</B></A>. An application can indicate status item changes about which it wants to be notified. By default, all status reporting is disabled except for LINEDEVSTATE_REINIT, which cannot be disabled. This message is sent to all applications that have a handle to the line, including those that called <A HREF="func2_34by.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func2_34by.htm"><B>lineOpen</B></A> with the <I>dwPrivileges</I> parameter set to LINECALLPRIVILEGE_NONE, LINECALLPRIVILEGE_OWNER, LINECALLPRIVILEGE_MONITOR, or permitted combinations of these. </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_1hyd.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/msgs_1hyd.htm">LINE_CLOSE</A>, <A HREF="msgs_5qlh.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/msgs_5qlh.htm">LINE_CREATE</A>, <A HREF="struc2_67aq.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/struc2_67aq.htm"><B>LINEDEVCAPS</B></A>, <A HREF="func1_2lbn.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func1_2lbn.htm"><B>lineGetDevCaps</B></A>, <A HREF="func1_078n.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func1_078n.htm"><B>lineGetDevConfig</B></A>, <A HREF="func1_0sc3.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func1_0sc3.htm"><B>lineGetTranslateCaps</B></A>, <A HREF="func1_26lh.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func1_26lh.htm"><B>lineInitialize</B></A>, <A HREF="func2_34by.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func2_34by.htm"><B>lineOpen</B></A>, <A HREF="func2_3upf.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func2_3upf.htm"><B>lineSetStatusMessages</B></A>, <A HREF="func2_7sq6.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func2_7sq6.htm"><B>lineShutdown</B></A>, <A HREF="struc2_4w36.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/struc2_4w36.htm"><B>LINETRANSLATECAPS</B></A>, <A HREF="func2_54vg.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func2_54vg.htm"><B>lineUncompleteCall</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 + -