fonction lineDevSpecific (tapi.h)

Article
08/26/2023

La fonction lineDevSpecific permet aux fournisseurs de services de fournir l’accès aux fonctionnalités qui ne sont pas proposées par d’autres fonctions TAPI. La signification des extensions est spécifique à l’appareil, et pour tirer parti de ces extensions, l’application doit en être pleinement consciente.

Syntaxe

LONG lineDevSpecific(
  HLINE  hLine,
  DWORD  dwAddressID,
  HCALL  hCall,
  LPVOID lpParams,
  DWORD  dwSize
);

Paramètres

hLine

Gérer sur un appareil de ligne. Ce paramètre est obligatoire.

dwAddressID

Identificateur d’adresse sur l’appareil de ligne donné. Un identificateur d’adresse est associé de façon permanente à une adresse ; l’identificateur reste constant entre les mises à niveau du système d’exploitation.

hCall

Gérer à un appel. Ce paramètre est facultatif, mais s’il est spécifié, l’appel qu’il représente doit appartenir à l’appareil de ligne hLine . L’état de l’appel de hCall est spécifique à l’appareil.

lpParams

Pointeur vers une zone de mémoire utilisée pour contenir un bloc de paramètres. 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 à partir de celui-ci.

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 LINE_REPLY correspondant est égal à zéro si la fonction réussit, ou il s’agit d’un numéro d’erreur négatif si une erreur se produit. Les valeurs de retour possibles sont les suivantes :

LINEERR_INVALADDRESSID, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALCALLHANDLE, LINEERR_OPERATIONFAILED, LINEERR_INVALLINEHANDLE, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALPOINTER, LINEERR_UNINITIALIZED, LINEERR_NOMEM.

Les valeurs de retour supplémentaires sont spécifiques à l’appareil.

Remarques

Cette opération fait partie des services de téléphonie étendus. 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 correctement négocié une version d’extension spécifique à l’appareil.

Cette fonction fournit un profil de paramètre générique. L’interprétation de la structure des paramètres est spécifique à l’appareil. La validité de dwAddressID et/ou hCall est spécifique à l’appareil. S’ils sont spécifiés, ils doivent appartenir à hLine. Les indications et les réponses renvoyées à l’application qui sont spécifiques à l’appareil doivent utiliser le message LINE_DEVSPECIFIC .

Un fournisseur de services peut fournir l’accès à des fonctions spécifiques à l’appareil en définissant des paramètres à utiliser avec cette fonction. Les applications qui souhaitent utiliser ces extensions spécifiques à l’appareil doivent consulter la documentation spécifique à l’appareil (dans ce cas, 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 en mesure de fonctionner avec d’autres environnements de fournisseur de services.

Attention TAPI écrit les données retournées dans la mémoire tampon référencée par lParam lorsque le message LINE_REPLY est retourné. Cela signifie que la mémoire tampon doit rester valide jusqu’à ce que le message LINE_REPLY soit retourné ; sinon, une altération des données et des exceptions peuvent se produire.