lineDevSpecificFeature, fonction (tapi.h)
La fonction lineDevSpecificFeature permet aux fournisseurs de services de fournir l’accès aux fonctionnalités non offertes par d’autres fonctions TAPI. La signification de ces extensions est spécifique à l’appareil, et tirer parti de ces extensions nécessite que l’application en soit pleinement consciente.
Syntaxe
LONG lineDevSpecificFeature(
HLINE hLine,
DWORD dwFeature,
LPVOID lpParams,
DWORD dwSize
);
Paramètres
hLine
Gérez l’appareil de ligne.
dwFeature
Fonctionnalité à appeler sur l’appareil de ligne. Ce paramètre utilise les constantes PHONEBUTTONFUNCTION_.
lpParams
Pointeur vers une zone de mémoire utilisée pour contenir un bloc de paramètres dépendant des fonctionnalités. Le format de ce bloc de paramètres est spécifique à l’appareil et son contenu est transmis par TAPI au fournisseur de services ou depuis celui-ci.
dwSize
Taille de la mémoire tampon, 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 LINE_REPLY correspondant est égal à zéro si la fonction réussit ou s’il s’agit d’un nombre d’erreur négatif si une erreur se produit. Les valeurs de retour possibles sont les suivantes :
LINEERR_INVALFEATURE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALLINEHANDLE, LINEERR_OPERATIONFAILED, LINEERR_INVALPOINTER, LINEERR_RESOURCEUNAVAIL, LINEERR_NOMEM, LINEERR_UNINITIALIZED.
Les valeurs de retour supplémentaires sont spécifiques à l’appareil.
Remarques
Cette opération fait partie des services de téléphonie étendue. Il permet d’accéder à une fonctionnalité spécifique à l’appareil sans définir sa signification. Cette opération n’est disponible que si l’application a négocié avec succès une version d’extension spécifique à l’appareil.
Cette fonction fournit à l’application des fonctionnalités d’émulation de bouton de téléphone. Lorsqu’une application appelle cette opération, elle spécifie l’équivalent d’un événement d’appui sur bouton. Cette méthode d’appel des fonctionnalités dépend de l’appareil, car TAPI ne définit pas leur signification. En règle générale, une application qui s’appuie sur ces extensions spécifiques à l’appareil ne fonctionne pas avec d’autres environnements de fournisseur de services.
La structure pointée par lpParams ne doit pas contenir de pointeurs, car ils ne seraient pas correctement traduits (thunked) lors de l’exécution d’une application 16 bits dans une version 32 bits de TAPI et vice versa.
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