phoneGetID, fonction (tapi.h)

  • Article

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 les 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’appareils.

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_INVALPHONEHANDLE, PHONEERR_NOMEM, PHONEERR_INVALPOINTER, PHONEERR_RESOURCEUNAVAIL, PHONEERR_INVALDEVICECLASS, PHONEERR_UNINITIALIZED, PHONEERR_OPERATIONFAILED, PHONEERR_STRUCTURETOOSMALL, PHONEERR_OPERATIONUNAVAIL.

Remarques

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’appareils 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’appareils 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 Classes d’appareils TAPI pour les noms de classes d’appareils.

Un fournisseur qui définit un type de média spécifique à l’appareil doit également définir l’API (propriétaire) propre à l’appareil correspondante pour gérer les appareils du type de mé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 à la fois le fournisseur et, à la suite, le type de média. Par exemple : « intel/video ».

Configuration requise

Condition requise Valeur
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