Windows Telephony 1.0 Software Development Kit Release Notes 1. Quick Start 2. Guide to Documentation 3. Licensing and Redistribution 4. Support 5. Documentation Errata --------------------------------------------------------------------------- 1. Quick Start Running the Dialer application ============================== Before running the Dialer application, review Chapter 3 of the Windows Telephony Application Programmer's Guide (\TAPISDK\APIDOC\USERGDE\START.DOC) for instructions on installing and configuring the sample service provider for AT command set modems. Use the 'Configure Telephony' icon in the Windows Telephony 1.0 program group to start the Windows Telephony Control Panel. The Telephony Control Panel includes complete online help. Use the 'Dialer' icon to run the Dialer application. The Dialer application includes complete online help. Sample Code =========== Review \TAPISDK\APIDOC\USERGDE\START.DOC for details on getting started with the Dialer application sample code. Review \TAPISDK\SPIDOC\USERGDE\START.DOC for details on getting started with the AT service provider sample code. --------------------------------------------------------------------------- 2. Guide to Documentation Windows Telephony SDK documentation can be found in the following directories: Documentation Location Format ================== ===================== ========================== API and SPI help HELP\*.HLP Windows Help API user's guide APIDOC\USERGDE\*.DOC Word for Windows 2.0 SPI user's guide SPIDOC\USERGDE\*.DOC Word for Windows 2.0 API reference APIDOC\REF\*.DOC Word for Windows 2.0 SPI reference SPIDOC\REF\*.DOC Word for Windows 2.0 ATSP help REDIST\ATSP.HLP Windows Help Dialer help REDIST\DIALER.HLP Windows Help Control panel help REDIST\TELEPHON.HLP Windows Help Technical notes TECHNOTE\*.DOC Word for Windows 2.0 The ATSP, Dialer, and Control panel help files are also installed in the \WINDOWS and \WINDOWS\SYSTEM directories by the Windows Telephony Setup program. --------------------------------------------------------------------------- 3. Licensing and Redistribution Windows Telephony SDK licensing and redistribution terms are in \TAPISDK\LICENSE.TXT. --------------------------------------------------------------------------- 4. Support Microsoft Support Services ========================== If you have a question about the Windows Telephony Software Development Kit, first look in the product documentation or consult online Help. You can also find late-breaking updates and technical information in the Readme file that came with your Windows Telephony Software Development Kit files. If you cannot find the answer, contact the Microsoft Support Network. Outside the United States, contact Microsoft Product Support Services at the Microsoft subsidiary office that serves your area. The Microsoft Support Network ============================= The Microsoft Support Network offers you a wide range of choices and access to high-quality, responsive technical support. Microsoft recognizes that support needs vary from user to user; the Microsoft Support Network allows you to choose the type of support that best meets your needs, with options ranging from electronic bulletin boards to annual support programs. Services vary outside the United States and Canada. In other locations, contact a local Microsoft subsidiary for information. The Microsoft Support Network is subject to Microsoft's then-current prices, terms, and conditions, and is subject to change without notice. Product Support Within the United States and Canada =================================================== In the United States and Canada, the following support services are available through the Microsoft Support Network: Electronic Services - These services are available 24 hours a day, 7 days a week, including holidays. Microsoft FastTips - (800) 936-4300 on a touch-tone telephone. Receive automated answers to common questions, and access a library of technical notes, all delivered by recording or fax. You can use the following keys on your touch-tone telephone after you reach FastTips: To Press == ===== Advance to the next message * Repeat the current message 7 Return to the beginning of FastTips # CompuServe - Interact with other users and Microsoft support engineers, or access the Microsoft Knowledge Base to get product information. At any ! prompt, type "go microsoft" to access Microsoft forums, or type "go mskb" to access the Microsoft Knowledge Base. For an introductory CompuServe membership kit, call (800) 848-8199, operator 521. Microsoft Download Service - Access, via modem, the Driver Library and the most current technical notes (1200, 2400, or 9600 baud; no parity; 8 data bits; 1 stop bit). In the United States, call (206) 936-6735. In Canada, call (905) 507-3022. Internet - Access the Driver Library and the Microsoft Knowledge Base. The Microsoft Internet FTP archive host, ftp.microsoft.com, supports anonymous login. When logging in as anonymous, you should type your complete electronic mail name as your password. Priority Support - The Microsoft Support Network offers priority telephone access to Microsoft support engineers 24 hours a day, 7 days a week, except holidays. > In the United States, call (900) 555-2300; $2 (U.S.) per minute, $95 (U.S.) maximum. Charges appear on your telephone bill. Not available in Canada. > In the United States, call (800) 936-5800; $95 (U.S.) per incident, billed to your VISA card, MasterCard, or American Express card. In Canada, call (800) 668-7975; $125 per incident, billed to your VISA card, MasterCard, or American Express card. Text Telephone - Microsoft text telephone (TT/TDD) services are available for the deaf or hard-of-hearing. In the United States, using a TT/TDD modem, dial (206) 635-4948 between 6:00 A.M. and 6:00 P.M. Pacific time, Monday through Friday, excluding holidays. In Canada, using a TT/TDD modem, dial (905) 568-9641 between 8:30 A.M. and 6:30 P.M. Eastern time, Monday through Friday, excluding holidays. Other Support Options - The Microsoft Support Network offers annual and multiple incident support plans. For information, in the United States, contact the Microsoft Support Network Sales and Information group at (800) 936-3500 between 6:00 A.M. and 6:00 P.M. Pacific time, Monday through Friday, excluding holidays. In Canada, call (800) 563-9048 between 8:30 A.M. and 6:30 P.M. Eastern time, Monday through Friday, excluding holidays. Product Training and Consultation ================================= Microsoft Solution Providers are independent organizations that provide consulting, integration, customization, development, technical support and training, and other services for Microsoft products. These companies are called Solution Providers because they apply technology and provide services to help solve real-world problems. In the United States, for more information about the Microsoft Solution Providers program or the Microsoft Solution Provider nearest to you, please call (800) 426-9400 between 6:30 A.M. and 5:30 P.M. Pacific time, Monday through Friday, excluding holidays. In Canada, call (800) 563-9048 between 8:30 A.M. and 6:30 P.M. Eastern time, Monday through Friday, excluding holidays. --------------------------------------------------------------------------- 4. Documentation Errata Current TAPI/TSPI Version ========================= All Telephony applications and service providers must include a constant which identifies the TAPI or TSPI version they support. This value is passed into lineNegotiateAPIVersion and phoneNegotiateAPIVersion, and is used by service providers in the handling of TSPI_lineNegotiateTSPIVersion and TSPI_phoneNegotiateTSPIVersion. The TAPI and TSPI version supported by TAPI.DLL in this release of the SDK is 0x00010003. Applications Should Call lineInitialize before phoneInitialize ============================================================== When the first Telephony application causes TAPI.DLL to be loaded, TAPI.DLL calls the TSPI_providerInit functions in all installed service providers. If any of the providers detects a problem, it will return an error to TSPI_providerInit, causing the startup of the Telephony system to fail. The error value returned by the provider is propagated up to the application as the return value to lineInitialize or phoneInitialize, and the application may choose to interpret this value and display a meaningful error dialog to the user. The errors returned by TSPI_providerInit are expressed in terms of LINEERR constants rather than PHONEERR constants, so if an application intends to be able to provide correct feedback to users it should call lineInitialize first rather than phoneInitialize so that any error codes propagated up from TSPI_providerInit will be in the proper context. Service Providers Must Include Windows Version Resource and OEMSETUP.INF ======================================================================== In order to be recognized and installed by the Telephony Control Panel, service providers must include a valid Windows version resource in the .TSP file. Also, as with all Windows drivers, they must include an OEMSETUP.INF file specifying their components and where they are to be installed by the Control Panel. The source code for the sample service provider (ATSP) demonstrates both of these. Further information on OEMSETUP.INF files is available in the Windows Device Driver Development Kit and on the Development Library CD. Direct Dialing Rules ==================== The [Countries] section of the TELEPHON.INI file is intended to contain direct dialing procedures for every country in the world. As you might expect, actually collecting this information is not a simple process. Microsoft does have great confidence in the validity of the entries for most countries, but there are some in which we could not find any contact and the entries are essentially "blank". Also, these rules sometimes change with time; for example, the European Community is currently undergoing a process of normalizing the dialing procedures in all member countries, which will result in some changes over the next few years. If you become aware of the need for a correction or addition to the direct dialing rules in the [Countries] section, please send that information by email to "telephon@microsoft.com" or fax to the Windows Telephony Coordinator at +1 (206) 936-7329. This will allow us to be sure that the direct dialing rules shipped with future version of the SDK are as correct and up-to-date as possible, and, if necessary, to provide patches or other interim update information to developers and users who reside in or travel to the affected countries. How To Find Service Providers ============================= Developers of commercial applications and service providers are strongly encouraged to read and comment on the Technical Note 1 (LEVELS.DOC in the \TAPISDK\TECHNOTE directory). Application developers desiring to contact service provider developers for information on obtaining service providers should check Technical Note 3 (SPIVEND.DOC in the \TAPISDK\TECHNOTE directory). Service provider developers desiring to be included in future versions of this list should send email to "telephon@microsoft.com" or a fax to the Windows Telephony Coordinator at +1 (206) 936-7329 for further information. Diagnosing Improper Hardware or Software Configurations ======================================================= This section replaces the section on diagnosing improper ATSP/Dialer configurations in Chapter 3 of the Telephony Programmer's Guide (file APIDOC\USERGDE\START.DOC). When starting Dialer for the first time, you may see one of the following error messages if your hardware or software is not properly installed. "Your Telephony configuration file may be corrupted. Please use the Telephony Control Panel to try to repair it." This message means that you have no TELEPHON.INI file. -------------------------- "Dialer was unable to find a voice line. Please use the Telephony Control Panel to add or configure a voice line device driver." This message means that you have a TELEPHON.INI but there is no service provider installed that supports LINEMEDIAMODE_INTERACTIVEVOICE. You should exit Dialer, start the Telephony Control Panel, and check under " Driver Setup..." to ensure you have installed the AT modem service provider or another provider that supports LINEMEDIAMODE_INTERACTIVEVOICE. -------------------------- After starting Dialer and dialing a call, you may see this error message: "The selected line device is temporarily unable to handle requests from Dialer because of how it is being used by other applications. Please try again after the other applications complete." This message means that either: (1) when setting up ATSP you specified a COM port that is not present on your machine, or (2) another application has the COM port opened. To fix (1) you should exit Dialer, start the Telephony Control Panel, and check the COM port setting specified for the service provider associated with the preferred line. You can also try setting Dialer's preferred line to a different line if you have more than one line available on your machine. To fix (2) you should either select a different preferred line (if available) or stop the application which has opened the COM port you wish to use.