struc1_904y.htm

TAPI Exampple

<DT><B>dwOrigAddressOffset</B> </DT>

<DD>The size, in bytes, of the variably sized field holding the originating address, and the offset, in bytes, from the beginning of this data structure. The format of this address is dependent on the <B>dwAddressMode</B> member. </DD>

<DT><B>dwDisplayableAddressSize</B> </DT>

<DT><B>dwDisplayableAddressOffset</B> </DT>

<DD>The displayable string is used for logging purposes. The content of these members is recorded in the <B>dwDisplayableAddressOffset</B> and <B>dwDisplayableAddressSize</B> members of the call's LINECALLINFO message. The <A HREF="func2_69mb.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func2_69mb.htm"><B>lineTranslateAddress</B></A> function returns appropriate information to be placed in this field in the <B>dwDisplayableAddressSize</B> and <B>dwDisplayableAddressOffset</B> members of the <A HREF="struc2_3lo2.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/struc2_3lo2.htm"><B>LINETRANSLATEOUTPUT</B></A> structure. </DD>

<DT><B>dwCalledPartySize</B> </DT>

<DT><B>dwCalledPartyOffset</B> </DT>

<DD>The size, in bytes, of the variably sized field holding called-party information, and the offset, in bytes, from the beginning of this data structure. This information can be specified by the application that makes the call and is made available in the call's information structure for logging purposes. The format of this field is that of <B>dwStringFormat</B>, as specified in <A HREF="struc2_67aq.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/struc2_67aq.htm"><B>LINEDEVCAPS</B></A>. </DD>

<DT><B>dwCommentSize</B> </DT>

<DT><B>dwCommentOffset</B> </DT>

<DD>The size, in bytes, of the variably sized field holding comments about the call, and the offset, in bytes, from the beginning of this data structure. This information can be specified by the application that makes the call and is made available in the call's information structure for logging purposes. The format of this field is that of <B>dwStringFormat</B>, as specified in <B>LINEDEVCAPS</B>. </DD>

<DT><B>dwUserUserInfoSize</B> </DT>

<DT><B>dwUserUserInfoOffset</B> </DT>

<DD>The size, in bytes, of the variably sized field holding user-user information, and the offset, in bytes, from the beginning of this data structure. The protocol discriminator field for the user-user information, if required, should appear as the first byte of the data pointed to by <B>dwUserUserInfoOffset</B>, and must be accounted for in <B>dwUserUserInfoSize</B>. </DD>

<DT><B>dwHighLevelCompSize</B> </DT>

<DT><B>dwHighLevelCompOffset</B> </DT>

<DD>The size, in bytes, of the variably sized field holding high-level compatibility information, and the offset, in bytes, from the beginning of this data structure </DD>

<DT><B>dwLowLevelCompSize</B> </DT>

<DT><B>dwLowLevelCompOffset</B> </DT>

<DD>The size, in bytes, of the variably sized field holding low-level compatibility information, and the offset, in bytes, from the beginning of this data structure. </DD>

<DT><B>dwDevSpecificSize</B> </DT>

<DT><B>dwDevSpecificOffset</B> </DT>

<DD>The size, in bytes, of the variably sized field holding device-specific information, and the offset, in bytes, from the beginning of this data structure </DD>

<DT><B>dwPredictiveAutoTransferStates</B> </DT>

<DD>The <A HREF="constnts_6t0z.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/constnts_6t0z.htm">LINECALLSTATE_ constants</A>, entry into which causes the call to be blind-transferred to the specified target address. Set to zero if automatic transfer is not desired. </DD>

<DT><B>dwTargetAddressSize</B> </DT>

<DT><B>dwTargetAddressOffset</B> </DT>

<DD>The size, in bytes, and offset from the beginning of <B>LINECALLPARAMS</B> of a string specifying the target dialable address (<I>not</I> <B>dwAddressID</B>); used in the case of certain automatic actions. In the case of predictive dialing, specifies the address to which the call should be automatically transferred. This is essentially the same string that would be passed to <A HREF="func1_36wi.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func1_36wi.htm"><B>lineBlindTransfer</B></A> if automatic transfer were not being used. Set to zero if automatic transfer is not desired. In the case of a No Hold Conference, specifies the address that should be conferenced to the call. In the case of a One Step Transfer, specifies the address to dial on the consultation call. </DD>

<DT><B>dwSendingFlowspecSize</B> </DT>

<DT><B>dwSendingFlowspecOffset</B> </DT>

<DD>The total size, in bytes, and offset from the beginning of <B>LINECALLPARAMS</B> of a WinSock2 <B>FLOWSPEC</B> structure followed by WinSock2 provider-specific data, equivalent to what would have been stored in SendingFlowspec.len in a WinSock2 <B>QOS</B> structure. Specifies the quality of service desired in the sending direction on the call. The provider-specific portion following the <B>FLOWSPEC</B> structure must not contain pointers to other blocks of memory, because TAPI does not know how to marshal the data pointed to by the private pointer(s) and convey it through interprocess communication to the application. </DD>

<DT><B>dwReceivingFlowspecSize</B> </DT>

<DT><B>dwReceivingFlowspecOffset</B> </DT>

<DD>The total size, in bytes, and offset from the beginning of <B>LINECALLPARAMS</B> of a WinSock2 <B>FLOWSPEC</B> structure followed by WinSock2 provider-specific data, equivalent to what would have been stored in ReceivingFlowspec.len in a WinSock2 <B>QOS</B> structure. Specifies the quality of service desired in the receiving direction on the call. The provider-specific portion following the <B>FLOWSPEC</B> structure must not contain pointers to other blocks of memory, because TAPI does not know how to marshal the data pointed to by the private pointer(s) and convey it through interprocess communication to the application. </DD>

<DT><B>dwDeviceClassSize</B> </DT>

<DT><B>dwDeviceClassOffset</B> </DT>

<DD>The size, in bytes, and offset from the beginning of <B>LINECALLPARAMS</B> of a null-terminated string (the size includes the NULL) that indicates the device class of the device whose configuration is specified in <I>DeviceConfig</I>. 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>

<DT><B>dwDeviceConfigSize</B> </DT>

<DT><B>dwDeviceConfigOffset</B> </DT>

<DD>The number of bytes and offset from the beginning of <B>LINECALLPARAMS</B> of the opaque configuration data structure pointed to by <B>dwDevConfigOffset</B>. This value is returned in the <B>dwStringSize</B> member in the <A HREF="struc2_8vle.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/struc2_8vle.htm"><B>VARSTRING</B></A> structure returned by <A HREF="func1_078n.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func1_078n.htm"><B>lineGetDevConfig</B></A>. If the size is zero, the default device configuration is used. This allows the application to set the device configuration before the call is initiated. </DD>

<DT><B>dwCallDataSize</B> </DT>

<DT><B>dwCallDataOffset</B> </DT>

<DD>The size, in bytes, and offset from the beginning of <B>LINECALLPARAMS</B> of the application-settable call data to be initially attached to the call. </DD>

<DT><B>dwNoAnswerTimeout</B> </DT>

<DD>The number of seconds, after the completion of dialing, that the call should be allowed to wait in the PROCEEDING or RINGBACK states, before it is automatically abandoned by the service provider with a LINECALLSTATE_DISCONNECTED and LINEDISCONNECTMODE_NOANSWER. A value of 0 indicates that the application does not desire automatic call abandonment. </DD>

<DT><B>dwCallingPartyIDSize</B> </DT>

<DT><B>dwCallingPartyIDOffset</B> </DT>

<DD>The size, in bytes, and offset from the beginning of <B>LINECALLPARAMS</B> of a null-terminated string (the size includes the NULL) that specifies the identity of the party placing the call. If the content of the identifier is acceptable and a path is available, the service provider passes the identifier along to the called party to indicate the identity of the calling party. </DD>

<DT><B>dwAddressType</B></DT>

<DD>The <A HREF="javascript:if(confirm('http://msdn.microsoft.com/library/psdk/tapi3/const_07sj.htm  \n\n这个文件不能通过 Teleport Pro 取回, 因为 地址在一个域或为它的开始地址设定的边界的外部路径上.  \n\n你想从服务器打开它吗?'))window.location='http://msdn.microsoft.com/library/psdk/tapi3/const_07sj.htm'" tppabs="http://msdn.microsoft.com/library/psdk/tapi3/const_07sj.htm">address type</A> used for the call. This member of the structure is available only if the negotiated TAPI version is 3.0 or higher. 
</DD>
</DL>

<H4>Remarks</H4>

<P>Device-specific extensions should use the <B>DevSpecific</B> (<B>dwDevSpecificSize</B> and <B>dwDevSpecificOffset</B>) variably sized area of this data structure. </P>

<P>This structure is used as a parameter to <A HREF="func1_7mgc.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func1_7mgc.htm"><B>lineMakeCall</B></A> when setting up a call. Its fields allow the application to specify the quality of service requested from the network as well as a variety of ISDN call-setup parameters. If no <B>LINECALLPARAMS</B> structure is supplied to <B>lineMakeCall</B>, a default POTS voice-grade call is requested with the default values listed above. </P>

<P class=note><B>Note</B>&nbsp;&nbsp;The fields <B>DialParams</B> through <B>dwDevSpecificOffset</B> are ignored when an <I>lpCallParams</I> parameter is specified with the <A HREF="func2_34by.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func2_34by.htm"><B>lineOpen</B></A> function. </P>

<P>The members <B>dwPredictiveAutoTransferStates</B> through <B>dwCallingPartyIDOffset</B> are available only to applications that open the line device with an API version of 2.0 or later. </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>&nbsp;&nbsp;Windows NT/2000: </B>Requires Windows NT 4.0 SP3 or later.<BR>
<B>&nbsp;&nbsp;Windows 95/98: </B>Requires Windows 95 or later.<BR>
<B>&nbsp;&nbsp;Version: </B>Requires TAPI 1.4 or later.<BR>
<B>&nbsp;&nbsp;Header: </B>Declared in Tapi.h.</P>

<H4>See Also</H4>

<P><A HREF="func1_36wi.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func1_36wi.htm"><B>lineBlindTransfer</B></A>, <A HREF="struc2_67aq.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/struc2_67aq.htm"><B>LINEDEVCAPS</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_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="func1_7mgc.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func1_7mgc.htm"><B>lineMakeCall</B></A>, <A HREF="javascript:if(confirm('http://msdn.microsoft.com/library/psdk/tspi21/func2_0r8s.htm  \n\n这个文件不能通过 Teleport Pro 取回, 因为 地址在一个域或为它的开始地址设定的边界的外部路径上.  \n\n你想从服务器打开它吗?'))window.location='http://msdn.microsoft.com/library/psdk/tspi21/func2_0r8s.htm'" tppabs="http://msdn.microsoft.com/library/psdk/tspi21/func2_0r8s.htm"><B>TSPI_lineMakeCall</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_69mb.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func2_69mb.htm"><B>lineTranslateAddress</B></A>, <A HREF="struc2_3lo2.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/struc2_3lo2.htm"><B>LINETRANSLATEOUTPUT</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:[e-mail]">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">&#169; 1999 Microsoft Corporation. All rights reserved. Terms of use.</A></P>
</DIV>
<!--FOOTER_END-->

</BODY>
</HTML>