Partager via


fonction phoneDevSpecific (tapi.h)

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.

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

PHONE_DEVSPECIFIC

PHONE_REPLY

Vue d’ensemble de la référence TAPI 2.2