?? func1_2lbn.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>lineGetDevCaps</TITLE>
<SCRIPT SRC="/library/psdk/linkcss.js"></SCRIPT>
<META NAME="MS-HKWD" CONTENT="lineGetDevCaps">
<META NAME="MS-HAID" CONTENT="_tapi2_linegetdevcaps">
</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_linegetdevcaps"></A>lineGetDevCaps</H1>
<P>The <B>lineGetDevCaps</B> function queries a specified line device to determine its telephony capabilities. The returned information is valid for all addresses on the line device. </P>
<PRE class=syntax><B>LONG WINAPI lineGetDevCaps(
HLINEAPP</B><I> hLineApp</I><B>, </B>
<B> DWORD</B><I> dwDeviceID</I><B>, </B>
<B> DWORD</B><I> dwAPIVersion</I><B>, </B>
<B> DWORD</B><I> dwExtVersion</I><B>, </B>
<B> LPLINEDEVCAPS</B><I> lpLineDevCaps </I>
<B>);</B></PRE>
<H4>Parameters</H4>
<DL>
<DT><I>hLineApp</I> </DT>
<DD>The handle to the application's registration with TAPI. </DD>
<DT><I>dwDeviceID</I> </DT>
<DD>The line device to be queried. </DD>
<DT><I>dwAPIVersion</I> </DT>
<DD>The version number of the Telephony API to be used. The high-order word contains the major version number; the low-order word contains the minor version number. This number is obtained by <A HREF="func2_9kxa.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func2_9kxa.htm"><B>lineNegotiateAPIVersion</B></A>. </DD>
<DT><I>dwExtVersion</I> </DT>
<DD>The version number of the service provider-specific extensions to be used. This number is obtained by <A HREF="func2_3p66.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func2_3p66.htm"><B>lineNegotiateExtVersion</B></A>. It can be left zero if no device-specific extensions are to be used. Otherwise, the high-order word contains the major version number; the low-order word contains the minor version number. </DD>
<DT><I>lpLineDevCaps</I> </DT>
<DD>A pointer to a variably sized structure of type <A HREF="struc2_67aq.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/struc2_67aq.htm"><B>LINEDEVCAPS</B></A>. Upon successful completion of the request, this structure is filled with line device capabilities information. Prior to calling <B>lineGetDevCaps</B>, the application should set the <B>dwTotalSize</B> member of this structure to indicate the amount of memory available to TAPI for returning information.
</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_BADDEVICEID, LINEERR_NOMEM, LINEERR_INCOMPATIBLEAPIVERSION, LINEERR_OPERATIONFAILED, LINEERR_INCOMPATIBLEEXTVERSION, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALAPPHANDLE, LINEERR_STRUCTURETOOSMALL, LINEERR_INVALPOINTER, LINEERR_UNINITIALIZED, LINEERR_NODRIVER, LINEERR_OPERATIONUNAVAIL, LINEERR_NODEVICE.</P>
<H4>Remarks</H4>
<P>Before using <B>lineGetDevCaps</B>, the application must negotiate the API version number to use, and, if desired, the extension version to use. </P>
<P>The API and extension version numbers are those under which TAPI and the service provider must operate. If version ranges do not overlap, the application, API, or service-provider versions are incompatible and an error is returned. </P>
<P>One of the members in the <A HREF="struc2_67aq.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/struc2_67aq.htm"><B>LINEDEVCAPS</B></A> structure returned by this function contains the number of addresses assigned to the specified line device. The actual address identifiers used to reference individual addresses vary from zero to one less than the returned number. The capabilities of each address can be different. Use <A HREF="func1_533n.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func1_533n.htm"><B>lineGetAddressCaps</B></A> for each available <<I>dwDeviceID</I>, <I>dwAddressID</I>> combination to determine the exact capabilities of each address. Note that an address identifier is permanently associated with an address; the identifier remains constant across operating system upgrades.</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 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_1pnp.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/quickref_1pnp.htm">Basic Telephony Services Reference</A>, <A HREF="struc2_67aq.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/struc2_67aq.htm"><B>LINEDEVCAPS</B></A>, <A HREF="func1_533n.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func1_533n.htm"><B>lineGetAddressCaps</B></A>, <A HREF="func2_9kxa.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func2_9kxa.htm"><B>lineNegotiateAPIVersion</B></A>, <A HREF="func2_3p66.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func2_3p66.htm"><B>lineNegotiateExtVersion</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 + -