📄 func2_0l5z.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>lineSetDevConfig</TITLE>
<SCRIPT SRC="/library/psdk/linkcss.js"></SCRIPT>
<META NAME="MS-HKWD" CONTENT="lineSetDevConfig">
<META NAME="MS-HAID" CONTENT="_tapi2_linesetdevconfig">
</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_linesetdevconfig"></A>lineSetDevConfig</H1>
<P>The <B>lineSetDevConfig</B> function allows the application to restore the configuration of a media stream device on a line device to a setup previously obtained using <A HREF="func1_078n.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func1_078n.htm"><B>lineGetDevConfig</B></A>. For example, the contents of this structure could specify data rate, character format, modulation schemes, and error control protocol settings for a "datamodem" media device associated with the line. </P>
<PRE class=syntax><B>LONG WINAPI lineSetDevConfig(
DWORD</B><I> dwDeviceID</I><B>, </B>
<B> LPVOID const</B><I> lpDeviceConfig</I><B>, </B>
<B> DWORD</B><I> dwSize</I><B>, </B>
<B> LPCSTR</B><I> lpszDeviceClass </I>
<B>);</B></PRE>
<H4>Parameters</H4>
<DL>
<DT><I>dwDeviceID</I> </DT>
<DD>The line device to be configured. </DD>
<DT><I>lpDeviceConfig</I> </DT>
<DD>A pointer to the opaque configuration data structure that was returned by <B>lineGetDevConfig</B> in the variable portion of the <A HREF="struc2_8vle.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/struc2_8vle.htm"><B>VARSTRING</B></A> structure. </DD>
<DT><I>dwSize</I> </DT>
<DD>The number of bytes in the structure pointed to by <I>lpDeviceConfig</I>. This value is returned in the <B>dwStringSize</B> member in the <B>VARSTRING</B> structure returned by <B>lineGetDevConfig</B>. </DD>
<DT><I>lpszDeviceClass</I> </DT>
<DD>A pointer to a null-terminated string that specifies the device class of the device whose configuration is to be set. Valid device class strings are the same as those specified for the <A HREF="func1_2gf8.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func1_2gf8.htm"><B>lineGetID</B></A> function.
</DD>
</DL>
<H4>Return Values</H4>
<P>Returns zero if the function succeeds or a negative error number if an error occurs. Possible return values are: </P>
<P>LINEERR_BADDEVICEID, LINEERR_NODRIVER, LINEERR_INVALDEVICECLASS, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALPOINTER, LINEERR_OPERATIONFAILED, LINEERR_INVALPARAM, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALLINESTATE, LINEERR_UNINITIALIZED, LINEERR_NOMEM, LINEERR_NODEVICE.</P>
<H4>Remarks</H4>
<P>Call states are device specific. </P>
<P>Typically, an application calls <A HREF="func1_2gf8.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func1_2gf8.htm"><B>lineGetID</B></A> to identify the media stream device associated with a line, and then calls <A HREF="func1_53tz.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func1_53tz.htm"><B>lineConfigDialog</B></A> to allow the user to set up the device configuration. It could then call <A HREF="func1_078n.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func1_078n.htm"><B>lineGetDevConfig</B></A> and save the configuration information in a phone book or other database associated with a particular call destination. When the user wants to call the same destination again, this <B>lineSetDevConfig</B> function can be used to restore the configuration settings selected by the user. The <B>lineSetDevConfig</B>, <B>lineConfigDialog</B>, and <B>lineGetDevConfig</B> functions can be used, in that order, to allow the user to view and update the settings. </P>
<P>The exact format of the data contained within the structure is specific to the line and media stream API (device class), is undocumented, and is undefined. The application must treat it as "opaque" and not manipulate the contents directly. Generally, the structure can be sent using this function only to the same device from which it was obtained. Certain telephony service providers may, however, permit structures to be interchanged between identical devices (that is, multiple ports on the same multiport modem card). Such interchangeability is not guaranteed in any way, even for devices of the same device class. </P>
<P>Some service providers may permit the configuration to be set while a call is active, and others may not. </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.<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="func1_53tz.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func1_53tz.htm"><B>lineConfigDialog</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_2gf8.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func1_2gf8.htm"><B>lineGetID</B></A>, <A HREF="struc2_8vle.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/struc2_8vle.htm"><B>VARSTRING</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 + -