fonction phoneDevSpecific (tapi.h)
La fonction phoneDevSpecific est utilisée comme mécanisme d’extension général pour permettre à une implémentation d’API de téléphonie de fournir des fonctionnalités qui ne sont pas décrites dans les autres fonctions TAPI. Les significations de ces extensions sont spécifiques à l’appareil.
Syntaxe
LONG phoneDevSpecific(
HPHONE hPhone,
LPVOID lpParams,
DWORD dwSize
);
Paramètres
hPhone
Gérer sur un appareil téléphonique.
lpParams
Pointeur vers une zone de mémoire utilisée pour contenir un bloc de paramètres. Son interprétation est spécifique à l’appareil. Le contenu du bloc de paramètres est transmis sans modification au fournisseur de services par TAPI.
dwSize
Taille de la zone de bloc de paramètres, en octets.
Valeur retournée
Retourne un identificateur de requête positif si la fonction est terminée de manière asynchrone ou un numéro d’erreur négatif si une erreur se produit. Le paramètre dwParam2 du message PHONE_REPLY correspondant est égal à zéro si la fonction réussit ou s’il s’agit d’un numéro d’erreur négatif si une erreur se produit. Les valeurs de retour possibles sont les suivantes :
PHONEERR_INVALPHONEHANDLE, PHONEERR_NOMEM, PHONEERR_INVALPOINTER, PHONEERR_RESOURCEUNAVAIL, PHONEERR_OPERATIONUNAVAIL, PHONEERR_UNINITIALIZED, PHONEERR_OPERATIONFAILED.
Les valeurs de retour supplémentaires sont spécifiques à l’appareil.
Remarques
Cette opération fournit un profil de paramètre générique. L’interprétation du bloc de paramètres est spécifique à l’appareil. Les indications et les réponses spécifiques à l’appareil doivent utiliser le message PHONE_DEVSPECIFIC .
Un fournisseur de services peut fournir l’accès aux fonctions spécifiques de l’appareil en définissant des paramètres à utiliser avec cette opération. Les applications qui souhaitent utiliser ces extensions spécifiques à l’appareil doivent consulter la documentation spécifique à l’appareil (propre au fournisseur) qui décrit les extensions définies. En règle générale, une application qui s’appuie sur ces extensions spécifiques à l’appareil n’est pas portable pour fonctionner avec d’autres environnements de fournisseur de services.
Configuration requise
Condition requise | Valeur |
---|---|
Plateforme cible | Windows |
En-tête | tapi.h |
Bibliothèque | Tapi32.lib |
DLL | Tapi32.dll |
Voir aussi
Informations de référence sur les services de téléphonie étendus