Microsoft KB Archive/108308

{|
 * width="100%"|

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

 * }

Q108308

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

-

SUMMARY
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.

MORE INFORMATION
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