TUISPI_phoneConfigDialog, fonction (tspi.h)
La fonction TUISPI_phoneConfigDialog permet au fournisseur de l’appareil téléphonique spécifié d’afficher une boîte de dialogue modale en tant que fenêtre enfant de hwndOwner pour permettre à l’utilisateur de configurer les paramètres liés à l’appareil téléphonique. Cette fonction rend la fonction TSPI_phoneConfigDialog obsolète dans les versions 2.0 et ultérieures (prises en charge dans les versions 1.4 et antérieures).
L’implémentation est facultative.
Syntaxe
LONG TSPIAPI TUISPI_phoneConfigDialog(
TUISPIDLLCALLBACK lpfnUIDLLCallback,
DWORD dwDeviceID,
HWND hwndOwner,
LPCWSTR lpszDeviceClass
);
Paramètres
lpfnUIDLLCallback
Pointeur vers une fonction que la DLL d’interface utilisateur peut appeler pour communiquer avec la DLL du fournisseur de services afin d’obtenir les informations nécessaires à l’affichage de la boîte de dialogue et à l’envoi de la configuration mise à jour au fournisseur de services.
dwDeviceID
Appareil téléphonique à configurer.
hwndOwner
Handle vers une fenêtre parente dans laquelle la fenêtre de boîte de dialogue doit être placée.
lpszDeviceClass
Pointeur vers une chaîne Unicode terminée par null qui identifie un nom de classe d’appareil. Cette classe d’appareil permet à l’appelant de sélectionner un sous-écran spécifique d’informations de configuration applicables à cette classe d’appareil. Si ce paramètre a la valeur NULL ou une chaîne vide, la boîte de dialogue de configuration de niveau supérieur est sélectionnée.
Valeur retournée
Retourne zéro si la fonction réussit, ou un numéro d’erreur si une erreur se produit. Les valeurs de retour possibles sont les suivantes :
PHONEERR_BADDEVICEID, PHONEERR_NOMEM, PHONEERR_INUSE, PHONEERR_OPERATIONFAILED, PHONEERR_INVALPARAM, PHONEERR_OPERATIONUNAVAIL, PHONEERR_INVALDEVICECLASS, PHONEERR_RESOURCEUNAVAIL.
Remarques
Le paramètre lpszDeviceClass permet à l’application de sélectionner un sous-écran spécifique d’informations de configuration applicables à la classe d’appareil qui intéresse l’utilisateur. Les chaînes autorisées sont les mêmes que pour TSPI_phoneGetID.
Par exemple, si le téléphone prend en charge l’API Comm, le passage de comm/datamodem en tant que lpszDeviceClass amène le fournisseur à afficher les paramètres liés spécifiquement à Comm (ou, au moins, à démarrer au point correspondant dans une chaîne de boîte de dialogue de configuration à plusieurs niveaux, afin que l’utilisateur n’ait pas à effectuer de recherche pour trouver les paramètres souhaités). Le paramètre szDeviceClass doit être « tapi/phone », « » ou NULL pour que le fournisseur affiche la configuration de niveau le plus élevé pour le téléphone.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Windows |
| En-tête | tspi.h |