<DD>Specifies the volume-setting capabilities of the phone device's speaker components. If the bit in position PHONEHOOKSWITCHDEV_ is TRUE, the volume of the corresponding hookswitch device's speaker component can be adjusted with <A HREF="func2_731h.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func2_731h.htm"><B>phoneSetVolume</B></A>; otherwise, FALSE. </DD>

<DT><B>dwGainFlags</B> </DT>

<DD>Specifies the gain-setting capabilities of the phone device's microphone components. If the bit position PHONEHOOKSWITCHDEV_ is TRUE, the volume of the corresponding hookswitch device's microphone component can be adjusted with <A HREF="func2_2ib2.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func2_2ib2.htm"><B>phoneSetGain</B></A>; otherwise, FALSE.</DD>

<DT><B>dwDisplayNumRows</B> </DT>

<DD>Specifies the display capabilities of the phone device by describing the number of rows in the phone display. The <B>dwDisplayNumRows</B> and <B>dwDisplayNumColumns</B> members are both zero for a phone device without a display. </DD>

<DT><B>dwDisplayNumColumns</B> </DT>

<DD>Specifies the display capabilities of the phone device by describing the number of columns in the phone display. The <B>dwDisplayNumRows</B> and <B>dwDisplayNumColumns</B> members are both zero for a phone device without a display. </DD>

<DT><B>dwNumRingModes</B> </DT>

<DD>The ring capabilities of the phone device. The phone is able to ring with <B>dwNumRingModes</B> different ring patterns, identified as 1, 2, through <B>dwNumRingModes</B> minus one. If the value of this member is 0, applications have no control over the ring mode of the phone. If the value of this member is greater than 0, it indicates the number of ring modes in addition to silence that are supported by the service provider. A value of 0 in the <I>lpdwRingMode</I> parameter of <A HREF="func2_2hk7.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func2_2hk7.htm"><B>phoneGetRing</B></A> or the <I>dwRingMode</I> parameter of <A HREF="func2_50tj.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func2_50tj.htm"><B>phoneSetRing</B></A> indicates silence (the phone is not ringing or should not be rung), and <I>dwRingMode</I> values of 1 to <B>dwNumRingModes</B> are valid ring modes for the phone device. </DD>

<DT><B>dwNumButtonLamps</B> </DT>

<DD>Specifies the number of button/lamps on the phone device that are detectable in TAPI. Button/lamps are identified by their identifier. Valid button/lamp identifiers range from zero to <B>dwNumButtonLamps</B> minus one. The keypad buttons '0', through '9', '*', and '#' are assigned the identifiers 0 through 12. </DD>

<DT><B>dwButtonModesSize</B> </DT>

<DT><B>dwButtonModesOffset</B> </DT>

<DD>The size, in bytes, and the offset from the beginning of this data structure in bytes of the variably sized field containing the button modes of the phone's buttons. The array is indexed by button/lamp identifier. This member uses one of the <A HREF="constnts_5aib.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/constnts_5aib.htm">PHONEBUTTONMODE_ Constants</A>. </DD>

<DT><B>dwButtonFunctionsSize</B> </DT>

<DT><B>dwButtonFunctionsOffset</B> </DT>

<DD>The size, in bytes, of the variably sized field containing the button modes of the phone's buttons, and the offset, in bytes, from the beginning of this data structure. This member uses one of the <A HREF="constnts_1a0j.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/constnts_1a0j.htm">PHONEBUTTONFUNCTION_ Constants</A>. The array is indexed by button/lamp identifier. </DD>

<DT><B>dwLampModesSize</B> </DT>

<DT><B>dwLampModesOffset</B> </DT>

<DD>The size, in bytes, of the variably sized field containing the lamp modes of the phone's lamps, and the offset, in bytes, from the beginning of this data structure. The array is indexed by button/lamp identifier. This member uses one of the <A HREF="constnts_5i43.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/constnts_5i43.htm">PHONELAMPMODE_ Constants</A>. </DD>

<DT><B>dwNumSetData</B> </DT>

<DD>The number of different download areas in the phone device. The different areas are referred to using the data IDs 0, 1, , <B>dwNumSetData</B> minus one. If this member is zero, the phone does not support the download capability. </DD>

<DT><B>dwSetDataSize</B> </DT>

<DT><B>dwSetDataOffset</B> </DT>

<DD>The size, in bytes, of the variably sized field containing the sizes (in bytes) of the phone's download data areas, and the offset, in bytes, from the beginning of this data structure. This is an array with <B>DWORD</B>-sized elements indexed by data identifier. </DD>

<DT><B>dwNumGetData</B> </DT>

<DD>The number of different upload areas in the phone device. The different areas are referred to using the data IDs 0, 1, , <B>dwNumGetData</B> minus one. If this field is zero, the phone does not support the upload capability. </DD>

<DT><B>dwGetDataSize</B> </DT>

<DT><B>dwGetDataOffset</B> </DT>

<DD>The size, in bytes, of the variably sized field containing the sizes (in bytes) of the phone's upload data areas, and the offset, in bytes, from the beginning of this data structure. This is an array with <B>DWORD</B>-sized elements indexed by data identifier. </DD>

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

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

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

<DT><B>dwDeviceClassesSize</B> </DT>

<DT><B>dwDeviceClassesOffset</B> </DT>

<DD>Length, in bytes, and offset from the beginning of <B>PHONECAPS</B> of a string consisting of the device class identifiers supported on this device for use with <A HREF="func2_1qxw.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func2_1qxw.htm"><B>phoneGetID</B></A>, separated by NULLs; the last identifier in the list is followed by two NULLs. </DD>

<DT><B>dwPhoneFeatures</B> </DT>

<DD>These flags indicate which Telephony API functions can be invoked on the phone. A zero indicates the corresponding feature is not implemented and can never be invoked by the application on the phone; a one indicates the feature may be invoked depending on the device state and other factors. This member uses <A HREF="constnts_1vg3.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/constnts_1vg3.htm">PHONEFEATURE_ Constants</A>. </DD>

<DT><B>dwSettableHandsetHookSwitchModes</B> </DT>

<DD>The <A HREF="constnts_0yyc.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/constnts_0yyc.htm">PHONEHOOKSWITCHMODE_</A> values that can be <I>set</I> on the handset using <A HREF="func2_2q7c.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func2_2q7c.htm"><B>phoneSetHookSwitch</B></A>. </DD>

<DT><B>dwSettableSpeakerHookSwitchModes</B> </DT>

<DD>The PHONEHOOKSWITCHMODE_ values that can be <I>set</I> on the speakerphone using <B>phoneSetHookSwitch</B>. </DD>

<DT><B>dwSettableHeadsetHookSwitchModes</B> </DT>

<DD>The PHONEHOOKSWITCHMODE_ values that can be <I>set</I> on the headset using <B>phoneSetHookSwitch</B>. </DD>

<DT><B>dwMonitoredHandsetHookSwitchModes</B> </DT>

<DD>The PHONEHOOKSWITCHMODE_ values that can be <I>detected</I> and <I>reported</I> for the handset in a <A HREF="msgs_3f8l.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/msgs_3f8l.htm">PHONE_STATE</A> message and by <A HREF="func2_7yy0.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func2_7yy0.htm"><B>phoneGetHookSwitch</B></A>. </DD>

<DT><B>dwMonitoredSpeakerHookSwitchModes</B> </DT>

<DD>The PHONEHOOKSWITCHMODE_ values that can be <I>detected</I> and <I>reported</I> for the speakerphone in a PHONE_STATE message and by <B>phoneGetHookSwitch</B>. </DD>

<DT><B>dwMonitoredHeadsetHookSwitchModes</B> </DT>

<DD>The <A HREF="constnts_0yyc.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/constnts_0yyc.htm">PHONEHOOKSWITCHMODE_</A> values that can be <I>detected</I> and <I>reported</I> for the headset in a PHONE_STATE message and by <B>phoneGetHookSwitch</B>. </DD>

<DT><B>PermanentPhoneGuid</B></DT>

<DD>The GUID permanently associated with this phone.
</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>The members <B>dwDeviceClassesSize</B> through <B>dwMonitoredHeadsetHookSwitchModes</B> are available only to applications that open the phone 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="msgs_77zi.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/msgs_77zi.htm">PHONE_BUTTON</A>, <A HREF="msgs_6751.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/msgs_6751.htm">PHONE_CLOSE</A>, <A HREF="msgs_3f8l.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/msgs_3f8l.htm">PHONE_STATE</A>, <A HREF="func2_3l6b.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func2_3l6b.htm"><B>phoneGetDevCaps</B></A>, <A HREF="javascript:if(confirm('http://msdn.microsoft.com/library/psdk/tspi21/func3_67ar.htm  \n\n這個文件不能通過 Teleport Pro 取回, 因為 地址在一個域或為它的開始地址設定的邊界的外部路徑上.  \n\n你想從服務器打開它嗎?'))window.location='http://msdn.microsoft.com/library/psdk/tspi21/func3_67ar.htm'" tppabs="http://msdn.microsoft.com/library/psdk/tspi21/func3_67ar.htm"><B>TSPI_phoneGetDevCaps</B></A>, <A HREF="func2_7yy0.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func2_7yy0.htm"><B>phoneGetHookSwitch</B></A>, <A HREF="func2_2hk7.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func2_2hk7.htm"><B>phoneGetRing</B></A>, <A HREF="func2_2ib2.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func2_2ib2.htm"><B>phoneSetGain</B></A>, <A HREF="func2_2q7c.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func2_2q7c.htm"><B>phoneSetHookSwitch</B></A>, <A HREF="func2_50tj.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func2_50tj.htm"><B>phoneSetRing</B></A>, <A HREF="func2_731h.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func2_731h.htm"><B>phoneSetVolume</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">&#169; 1999 Microsoft Corporation. All rights reserved. Terms of use.</A></P>
</DIV>
<!--FOOTER_END-->

</BODY>
</HTML>