fonction phoneDevSpecific (tapi.h)

Article
03/02/2024

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.