phoneGetID, fonction (tapi.h)

La fonction phoneGetID retourne un identificateur d’appareil pour la classe d’appareil donnée associée à l’appareil téléphonique spécifié.

Syntaxe

LONG phoneGetID(
  HPHONE      hPhone,
  LPVARSTRING lpDeviceID,
  LPCSTR      lpszDeviceClass
);

Paramètres

hPhone

Gérer sur un appareil téléphonique ouvert.

lpDeviceID

Pointeur vers une structure de données de type VARSTRING où l’identificateur de l’appareil est retourné. Une fois la demande terminée, cet emplacement est rempli avec l’identificateur de l’appareil. Le format des informations retournées dépend de la méthode utilisée par la classe d’appareil (API) pour nommer des appareils.

lpszDeviceClass

Pointeur vers une chaîne terminée par null qui spécifie la classe d’appareil de l’appareil dont l’identificateur est demandé. Les chaînes de classe d’appareil valides sont celles utilisées dans la section System.ini pour identifier les classes d’appareil.

Valeur retournée

Retourne zéro si la requête réussit ou si un numéro d’erreur négatif se produit. Les valeurs de retour possibles sont les suivantes :

PHONEERR_INVALPHONEHANDLE, PHONEERR_NOMEM, PHONEERR_INVALPOINTER, PHONEERR_RESOURCEUNAVAIL, PHONEERR_INVALDEVICECLASS, PHONEERR_UNINITIALIZED, PHONEERR_OPERATIONFAILED, PHONEERR_STRUCTURETOOSMALL, PHONEERR_OPERATIONUNAVAIL.

Notes

La fonction phoneGetID peut être utilisée pour récupérer un identificateur d’appareil téléphonique en fonction d’un handle de téléphone. Il peut également être utilisé pour obtenir l’identificateur de l’appareil multimédia (pour les classes d’appareil telles que COM, wave, MIDI, téléphone, ligne ou NDIS) associées à l’appareil téléphonique ouvert. Les noms de ces classes d’appareil ne respectent pas la casse. Cet identificateur peut ensuite être utilisé avec l’API multimédia appropriée pour sélectionner l’appareil correspondant.

Consultez les classes d’appareil TAPI pour connaître les noms de classes d’appareil.

Un fournisseur qui définit un type multimédia spécifique à l’appareil doit également définir l’API spécifique à l’appareil correspondant (propriétaire) pour gérer les appareils du type multimédia. Pour éviter les collisions sur les noms de classes d’appareils attribués indépendamment par différents fournisseurs, un fournisseur doit sélectionner un nom qui identifie de manière unique le fournisseur et, suivant celui-ci, le type de média. Par exemple : « intel/video ».

Configuration requise

   
Plateforme cible Windows
En-tête tapi.h
Bibliothèque Tapi32.lib
DLL Tapi32.dll

Voir aussi

Fonctions de service téléphonique supplémentaires

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

VARSTRING