📄 func1_9qcj.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>lineDevSpecific</TITLE>
<SCRIPT SRC="/library/psdk/linkcss.js"></SCRIPT>
<META NAME="MS-HKWD" CONTENT="lineDevSpecific">
<META NAME="MS-HAID" CONTENT="_tapi2_linedevspecific">
</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_linedevspecific"></A>lineDevSpecific</H1>
<P>The <B>lineDevSpecific</B> function enables service providers to provide access to features not offered by other TAPI functions. The meaning of the extensions are device specific, and taking advantage of these extensions requires the application to be fully aware of them. </P>
<PRE class=syntax><B>LONG WINAPI lineDevSpecific(
HLINE</B><I> hLine</I><B>, </B>
<B> DWORD</B><I> dwAddressID</I><B>, </B>
<B> HCALL</B><I> hCall</I><B>, </B>
<B> LPVOID</B><I> lpParams</I><B>, </B>
<B> DWORD</B><I> dwSize </I>
<B>);</B></PRE>
<H4>Parameters</H4>
<DL>
<DT><I>hLine</I> </DT>
<DD>A handle to a line device. This parameter is required. </DD>
<DT><I>dwAddressID</I> </DT>
<DD>An address identifier on the given line device. An address identifier is permanently associated with an address; the identifier remains constant across operating system upgrades.</DD>
<DT><I>hCall</I> </DT>
<DD>A handle to a call. This parameter is optional, but if it is specified, the call it represents must belong to the <I>hLine</I> line device. The call state of <I>hCall</I> is device specific. </DD>
<DT><I>lpParams</I> </DT>
<DD>A pointer to a memory area used to hold a parameter block. The format of this parameter block is device specific and its contents are passed by TAPI to or from the service provider. </DD>
<DT><I>dwSize</I> </DT>
<DD>The size in bytes of the parameter block area.
</DD>
</DL>
<H4>Return Values</H4>
<P>Returns a positive request identifier if the function is completed asynchronously, or a negative error number if an error occurs. The <I>dwParam2</I> parameter of the corresponding <A HREF="msgs_65mh.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/msgs_65mh.htm">LINE_REPLY</A> message is zero if the function succeeds, or it is a negative error number if an error occurs. Possible return values are: </P>
<P>LINEERR_INVALADDRESSID, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALCALLHANDLE, LINEERR_OPERATIONFAILED, LINEERR_INVALLINEHANDLE, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALPOINTER, LINEERR_UNINITIALIZED, LINEERR_NOMEM. </P>
<P>Additional return values are device specific. </P>
<H4>Remarks</H4>
<P>This operation is part of the Extended Telephony services. It provides access to a device-specific feature without defining its meaning. This operation is only available if the application has successfully negotiated a device-specific extension version. </P>
<P>This function provides a generic parameter profile. The interpretation of the parameter structure is device specific. Whether <I>dwAddressID</I> and/or <I>hCall</I> are expected to be valid is device specific. If specified, they must belong to <I>hLine</I>. Indications and replies sent back the application that are device specific should use the <A HREF="msgs_7i5f.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/msgs_7i5f.htm">LINE_DEVSPECIFIC</A> message. </P>
<P>A service provider can provide access to device-specific functions by defining parameters for use with this function. Applications that want to make use of these device-specific extensions should consult the device-specific (in this case, vendor-specific) documentation that describes what extensions are defined. Typically, an application that relies on these device-specific extensions is not able to work with other service provider environments. </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_3in9.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/quickref_3in9.htm">Extended Telephony Services Reference</A>, <A HREF="msgs_7i5f.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/msgs_7i5f.htm">LINE_DEVSPECIFIC</A>, <A HREF="msgs_65mh.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/msgs_65mh.htm">LINE_REPLY</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 + -