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

ID: 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 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 Tapi
Version : winnt:4.0
Platform : winnt
Issue type : kbinfo