PHONECAPS for Phones That Don't Report Button States

ID: Q108308

1.00 3.10 4.00 | 4.00

WINDOWS        | WINDOWS NT

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) included with: - Microsoft Windows NT version 4.0 - Microsoft Windows 95 version 4.0

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 reference words: 1.00 3.10 4.00 95 KBCategory: kbprg KBSubcategory: Tapi

Keywords          : kbTAPI Tapi 
Version           : 1.00 3.10 4.00 | 4.00
Platform          : NT WINDOWS

Last Reviewed: August 5, 1998