fonction TSPI_phoneGetDevCaps (tspi.h)

La fonction TSPI_phoneGetDevCaps interroge un appareil téléphonique spécifié pour déterminer ses capacités de téléphonie.

Syntaxe

LONG TSPIAPI TSPI_phoneGetDevCaps(
  DWORD       dwDeviceID,
  DWORD       dwTSPIVersion,
  DWORD       dwExtVersion,
  LPPHONECAPS lpPhoneCaps
);

Paramètres

dwDeviceID

Appareil téléphonique à interroger.

dwTSPIVersion

Numéro de version TSPI négocié. Cette valeur est négociée pour cet appareil via la fonction TSPI_phoneNegotiateTSPIVersion .

dwExtVersion

Numéro de version de l’extension négociée. Cette valeur est négociée pour cet appareil via la fonction TSPI_phoneNegotiateExtVersion .

lpPhoneCaps

Pointeur vers la mémoire dans lequel le fournisseur de services écrit une structure de taille variable de type PHONECAPS. Une fois la demande terminée, cette structure est remplie d’informations sur la capacité de l’appareil téléphonique. Avant d’appeler TSPI_phoneGetDevCaps, l’application définit le membre dwTotalSize de cette structure pour indiquer la quantité de mémoire disponible sur TAPI pour retourner des informations.

Valeur retournée

Retourne 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 :

PHONEERR_INCOMPATIBLEAPIVERSION, PHONEERR_RESOURCEUNAVAIL, PHONEERR_INCOMPATIBLEEXTVERSION, PHONEERR_OPERATIONFAILED, PHONEERR_NODRIVER, PHONEERR_OPERATIONUNAVAIL, PHONEERR_NOMEM.

Remarques

Le fournisseur de services remplit tous les membres de la structure de données PHONEBUTTONINFO , à l’exception de dwTotalSize, qui est renseigné par TAPI. Le fournisseur de services ne doit pas remplacer le membre dwTotalSize .

Si dwExtVersion est égal à zéro, aucune information d’extension n’est demandée. S’il n’est pas nul, il contient une valeur qui a déjà été négociée pour cet appareil avec la fonction TSPI_phoneNegotiateExtVersion . Le fournisseur de services renseigne des informations étendues spécifiques à l’appareil et au fournisseur en fonction de la version d’extension spécifiée.

Une fois que le fournisseur de services est retourné à partir de la fonction TSPI_phoneGetDevCaps , TAPI définit le membre dwPhoneStates de la structure PHONECAPS comme suit :

PHONECAPS.dwPhoneStates |=
    PHONESTATE_OWNER |
    PHONESTATE_MONITORS |
    PHONESTATE_REINIT;

Configuration requise

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

Voir aussi

PHONEBUTTONINFO

PHONECAPS

TSPI_phoneNegotiateExtVersion