Registrations are now open. Join us today!
There is still a lot of work to do on the wiki yet! More information about editing can be found here.
Already have an account?

Microsoft KB Archive/108308

From BetaArchive Wiki

INFO: PHONECAPS for Phones That Don't Report Button States


1.00 3.10 4.00 | 4.00 WINDOWS | WINDOWS NT kbprg

The information in this article applies to:

  • Microsoft Windows Telephony Software Development Kit (SDK) version 1.0 for Windows version 3.1
  • Microsoft Win32 Application Programming Interface (API), used with:
    • Microsoft Windows NT Server version 4.0
    • Microsoft Windows NT Workstation version 4.0
    • Microsoft Windows 95


A Windows Telephony application can call phoneGetDevCaps to inquire about a phone's telephony capabilities. The resulting function in the TAPI (Telephony application programming interface) service provider is TSPI_phoneGetDevCaps. If the phone device does not report button states, it is acceptable for the service provider to set the dwButtonModeSize/Offset fields in the PHONECAPS structure to 0 (zero). Alternatively, the provider could describe the button(s) as PHONEBUTTONMODE_DUMMY.


As a clarification, setting the dwButtonModeSize to 0 or describing the buttons as PHONEBUTTON_DUMMY does not prohibit the service provider from setting and using the dwButtonFunctionsSize and dwButtonFunctionsOffset members of the PHONECAPS structure.

Additional query words: 1.00 3.10

Keywords : kbTAPI
Issue type : kbinfo
Technology : kbAudDeveloper kbWin32sSearch kbWin32API

Last Reviewed: December 16, 2000
© 2001 Microsoft Corporation. All rights reserved. Terms of Use.