fonction TSPI_lineDevSpecific (tspi.h)

Article
03/13/2024

La fonction TSPI_lineDevSpecific est utilisée comme mécanisme d’extension général pour permettre aux fournisseurs de services de fournir l’accès aux fonctionnalités qui ne sont pas décrites dans d’autres opérations. Les significations des extensions sont spécifiques à l’appareil, et pour tirer parti de ces extensions, l’application doit en être pleinement consciente.

Syntaxe

LONG TSPIAPI TSPI_lineDevSpecific(
  DRV_REQUESTID dwRequestID,
  HDRVLINE      hdLine,
  DWORD         dwAddressID,
  HDRVCALL      hdCall,
  LPVOID        lpParams,
  DWORD         dwSize
);

Paramètres

dwRequestID

Identificateur de la requête asynchrone.

hdLine

Le handle du fournisseur de services pour la ligne à utiliser.

dwAddressID

Adresse sur la ligne spécifiée à utiliser. 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.

hdCall

Le handle du fournisseur de services pour l’appel à utiliser. Ce champ peut avoir la valeur NULL. L’état de l’appel de hdCall 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.

dwSize

Taille en octets de la zone de bloc de paramètres. Si le paramètre lpParams est un pointeur vers une chaîne, la taille doit inclure la terminaison null .

Valeur retournée

Retourne dwRequestID ou un numéro d’erreur si une erreur se produit. Le paramètre réel lResult de la ASYNC_COMPLETION correspondante est 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 :

LINEERR_INVALLINEHANDLE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALADDRESSID, LINEERR_OPERATIONFAILED, LINEERR_NOMEM, LINEERR_RESOURCEUNAVAIL.

Remarques

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

Cette opération fournit un profil de paramètre générique. L’interprétation de la structure des paramètres est spécifique à l’appareil. TAPI spécifie toujours le paramètre hdLine . La validité de dwAddressID et/ou hdCall est spécifique à l’appareil. S’ils sont spécifiés, ils doivent appartenir à hdLine. Les indications et les réponses envoyées à l’application qui sont spécifiques à l’appareil utilisent le message LINE_DEVSPECIFIC .

Cette fonction est appelée en réponse directe à une application appelant la ligne de fonction TAPIDevSpecific. TAPI traduit les paramètres hLine et hdCall utilisés au niveau TAPI en paramètres hdLine et hdCall correspondants utilisés au niveau TSPI. La mémoire tampon lpParams est passée sans modification.

Note La structure de données lpParams ne doit pas contenir de pointeurs, car ils ne seraient pas correctement traduits (mal) lors de l’exécution d’une application 16 bits dans une version 32 bits de TAPI et vice versa.

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 (dans ce cas, c’est-à-dire spécifique au fournisseur) qui décrit les extensions qui sont définies.

Note Une application qui s’appuie sur des extensions spécifiques à l’appareil n’est pas portable dans l’utilisation d’autres environnements de fournisseur de services. Utilisez des extensions spécifiques au fournisseur.

Cette opération fait partie des services de téléphonie étendus. Il fournit uniquement l’accès à 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é et sélectionné une version d’extension spécifique à l’appareil.

Configuration requise

Condition requise	Valeur
Plateforme cible	Windows
En-tête	tspi.h

Voir aussi

ASYNC_COMPLETION

LINE_DEVSPECIFIC

TSPI_lineNegotiateExtVersion

Partager via