fonction TSPI_lineDevSpecificFeature (tspi.h)

Article
03/06/2024

La fonction TSPI_lineDevSpecificFeature est utilisée comme mécanisme d’extension 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 de ces extensions sont spécifiques à l’appareil, et pour tirer parti de ces extensions, TAPI ou son application cliente doivent en être pleinement conscients.

Syntaxe

LONG TSPIAPI TSPI_lineDevSpecificFeature(
  DRV_REQUESTID dwRequestID,
  HDRVLINE      hdLine,
  DWORD         dwFeature,
  LPVOID        lpParams,
  DWORD         dwSize
);

Paramètres

dwRequestID

Identificateur de la requête asynchrone.

hdLine

Handle du fournisseur de services sur l’appareil de ligne.

dwFeature

Fonctionnalité à appeler sur l’appareil de ligne. Ce paramètre utilise des 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.

dwSize

Taille de la mémoire tampon en octets. 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_INVALFEATURE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALLINEHANDLE, LINEERR_OPERATIONFAILED, LINEERR_NOMEM, LINEERR_RESOURCEUNAVAIL.

Remarques

Les valeurs de retour supplémentaires sont spécifiques à l’appareil. L’état de l’appel de hdCall est spécifique à l’appareil.

Cette fonction fournit aux applications TAPI des fonctionnalités d’émulation de bouton de téléphone. Lorsque TAPI appelle cette opération pour le compte d’une application cliente, il spécifie l’équivalent d’un événement « appuyez sur le bouton ». Cette méthode d’appel de fonctionnalités dépend fortement de l’appareil, car l’API ne définit pas leur signification. Lorsqu’une application s’appuie sur des extensions spécifiques à l’appareil, l’application ne se porte pas correctement vers d’autres environnements de fournisseur de services.

Cette fonction est appelée en réponse directe à une application appelant la fonction TAPI lineDevSpecificFeature . TAPI traduit le paramètre hLine utilisé au niveau TAPI en paramètre hdLine correspondant utilisé au niveau TSPI. La mémoire tampon lpParams est passée via une mémoire tampon non modifiée.

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

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 TAPI 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_DEVSPECIFICFEATURE

constantes PHONEBUTTONFUNCTION_

Partager via