Lancer une session

Les informations principales fournies par une application pour lancer une session de communication sont le type d’adresse, le ou les types de média et l’adresse de destination.

L’adresse de destination peut nécessiter une traduction d’adresse pour placer les informations entrées par un utilisateur dans le format approprié pour un type d’adresse donné. Par exemple, un numéro de téléphone qui se trouvait dans un carnet d’adresses électronique au format canonique nécessite une traduction au format de numérotation .

Certaines sessions peuvent nécessiter des paramètres d’installation spéciaux, si elles sont prises en charge par le fournisseur de services. Par exemple, un fournisseur TSP ISDN peut transmettre des informations utilisateur-utilisateur, et certains FOURNISSEURS de services de sécurité nécessitent des informations sur la direction du flux multimédia. Consultez Informations de session pour un examen des données qui peuvent être définies ou obtenues concernant une session.

Une fois qu’une session a été lancée, TAPI informe l’application de la progression de l’appel à l’aide du mécanisme de notification d’événement configuré lors de l’initialisation.

TAPI 2.x : Les applications lancent une session à l’aide de la fonction lineMakeCall . La fonction lineTranslateAddress est utilisée pour effectuer la traduction d’adresses, si nécessaire.

Les paramètres de configuration des appels peuvent être stockés dans la structure de données LINECALLPARAMS , et un pointeur vers cette structure est ensuite utilisé comme paramètre de lineMakeCall. Si aucune structure LINECALLPARAMS n’est fournie à lineMakeCall, un appel de qualité vocale POTS par défaut est demandé avec un ensemble de valeurs par défaut.

Si la session est correctement configurée, un descripteur d’appel avec des privilègesde propriétaire est retourné à l’application et TAPI envoie l’application LINE_CALLSTATE messages avec des informations sur la progression de l’appel. Les applications utilisent généralement ces messages pour afficher status rapports à l’utilisateur.

TAPI 3.x : Les applications lancent une session de communication en appelant la méthode ITAddress::CreateCall sur une adresse capable de gérer le type d’adresse et le type de média requis. Si l’adresse expose l’interface ITTerminalSupport , les terminaux sont sélectionnés sur les flux multimédias de l’objet d’appel. Pour obtenir une illustration de ce processus, consultez l’exemple De code Effectuer un appel .

Les paramètres de configuration des appels peuvent être stockés ou modifiés à l’aide des méthodes exposées par l’interface ITCallInfo .

Si la session est correctement configurée, TAPI renvoie un pointeur d’interface ITBasicCallControl qui peut être utilisé pour d’autres opérations de session ou pour obtenir un pointeur d’interface ITCallInfo qui peut être utilisé pour obtenir des informations de session supplémentaires. L’interface ITCallStateEvent traite les événements d’état d’appel TAPI.

Notes

TapI ne doit pas être utilisé pour les transmissions par télécopie. Utilisez plutôt les fonctions disponibles via MAPI, l’API Messages Microsoft.

 

Traduction d’adresses

Un utilisateur final ou une application serveur peut stocker des adresses dans un format qui n’est pas compatible avec les besoins d’un fournisseur de services donné. Par exemple, un numéro de téléphone peut être stocké dans un carnet d’adresses électronique au format canonique, mais la plupart des fournisseurs de services qui gèrent les numéros de téléphone nécessitent le format de numérotation.

TAPI fournit des opérations de traduction d’adresses qui aident une application à présenter le type d’adresse approprié à un TSP. Le fournisseur de services spécifie à TAPI les types d’adresses qu’il prend en charge et ne doit inclure aucune forme de traduction d’adresse.

TAPI 2.x : Consultez lineTranslateAddress.

TAPI 3 : Consultez ITAddressTranslation, ITAddressTranslationInfo.

Listes de péages

Dans certains endroits de Amérique du Nord, tous les appels téléphoniques passés à l’indicatif régional local sont des appels locaux. Dans d’autres emplacements, certains appels passés à l’indicatif régional local sont de longue distance et nécessitent un préfixe « 1 » pour être composés. Les trois premiers chiffres de l’adresse (préfixe) déterminent si un appel dans l’indicatif régional local est un appel payant.

Une liste de péages est une liste de préfixes dans l’indicatif régional local dont les adresses doivent être composer en tant qu’adresses interurbaines et sont évaluées des frais d’interurbain.

Les listes de péages ne concernent pas les fournisseurs de services ou les applications qui n’accèdent pas à un réseau téléphonique.

TAPI 2.x : Consultez lineTranslateAddress (LINETRANSLATERESULT_INTOLLLIST et LINETRANSLATERESULT_NOTINTOLLLIST bits dans la structure LINETRANSLATEOUTPUT ), lineSetTollList.

TAPI 3 : Consultez ITAddressTranslation::TranslateAddress, ITAddressTranslationInfo::get_TranslationResults.