fonction phoneGetDevCaps (tapi.h)

Article
08/26/2023

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

Syntaxe

LONG phoneGetDevCaps(
  HPHONEAPP   hPhoneApp,
  DWORD       dwDeviceID,
  DWORD       dwAPIVersion,
  DWORD       dwExtVersion,
  LPPHONECAPS lpPhoneCaps
);

Paramètres

hPhoneApp

Gérez l’inscription de l’application avec TAPI.

dwDeviceID

Identificateur de l’appareil téléphonique à interroger.

dwAPIVersion

Numéro de version de l’API de téléphonie à utiliser. Le mot d’ordre supérieur contient le numéro de version principale ; le mot d’ordre inférieur contient le numéro de version secondaire. Ce nombre est obtenu avec la fonction phoneNegotiateAPIVersion.

dwExtVersion

Numéro de version des extensions spécifiques au fournisseur de services à utiliser. Ce nombre est obtenu avec la fonction phoneNegotiateExtVersion. Il peut être laissé zéro si aucune extension spécifique à l’appareil ne doit être utilisée. Sinon, le mot d’ordre supérieur contient le numéro de version principale ; le mot d’ordre inférieur contient le numéro de version secondaire.

lpPhoneCaps

Pointeur vers une structure de taille variable de type PHONECAPS. Une fois la demande terminée, cette structure est remplie avec des informations sur les fonctionnalités de l’appareil téléphonique.

Valeur retournée

Retourne zéro si la demande réussit ou un nombre d’erreur négatif si une erreur se produit. Les valeurs de retour possibles sont les suivantes :

PHONEERR_INVALAPPHANDLE, PHONEERR_INVALPOINTER, PHONEERR_BADDEVICEID, PHONEERR_OPERATIONFAILED, PHONEERR_INCOMPATIBLEAPIVERSION, PHONEERR_OPERATIONUNAVAIL, PHONEERR_INCOMPATIBLEEXTVERSION, PHONEERR_NOMEM, PHONEERR_STRUCTURETOOSMALL, PHONEERR_RESOURCEUNAVAIL, PHONEERR_NODRIVER, PHONEERR_UNINITIALIZED, PHONEERR_NODEVICE.

Remarques

Avant d’utiliser phoneGetDevCaps, l’application doit négocier le numéro de version TAPI à utiliser (voir phoneNegotiateAPIVersion) et, éventuellement, la version de l’extension à utiliser (voir phoneNegotiateExtVersion).

Les numéros TAPI et de version d’extension sont ceux sous lesquels TAPI, LA DLL de téléphonie et le fournisseur de services doivent fonctionner. Si les plages de versions ne se chevauchent pas, les versions de l’application et de l’API ou du fournisseur de services sont incompatibles et une erreur est retournée.