TSPI_phoneDevSpecific, fonction (tspi.h)
La fonction TSPI_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 non décrites dans les autres opérations. Les significations de ces extensions sont spécifiques à l’appareil.
Syntaxe
LONG TSPIAPI TSPI_phoneDevSpecific(
DRV_REQUESTID dwRequestID,
HDRVPHONE hdPhone,
LPVOID lpParams,
DWORD dwSize
);
Paramètres
dwRequestID
Identificateur de la requête asynchrone.
hdPhone
Handle du téléphone sur lequel une opération spécifique à l’appareil doit être effectuée.
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 paramètre lpParams ne doit pas contenir de pointeurs. Pour obtenir des informations à l’application à partir de TSPI_phoneDevSpecific, le fournisseur de services envoie un message PHONE_DEVSPECIFIC avec les informations.
dwSize
Taille en octets de la zone de bloc de paramètres.
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 égal à zéro si la fonction réussit ou s’il s’agit d’un numéro d’erreur si une erreur se produit. Les valeurs de retour possibles sont les suivantes :
PHONEERR_INVALPHONEHANDLE, PHONEERR_OPERATIONUNAVAIL, PHONEERR_INVALPOINTER, PHONEERR_NOMEM, PHONEERR_OPERATIONFAILED, PHONEERR_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 du bloc de paramètres est spécifique à l’appareil. Les indications et réponses spécifiques à l’appareil doivent utiliser le message PHONE_DEVSPECIFIC .
Cette fonction est appelée en réponse directe à une application qui a appelé la fonction TAPI phoneDevSpecific . TAPI convertit le paramètre hPhone utilisé au niveau TAPI en paramètre hdPhone correspondant utilisé au niveau TSPI. La mémoire tampon lpParams est passée via une mémoire tampon non modifiée.
Un fournisseur de services peut fournir l’accès à des fonctions spécifiques à 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.
Configuration requise
| Plateforme cible | Windows |
| En-tête | tspi.h |