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