lineGetIDA, fonction (tapi.h)

La fonction lineGetID retourne un identificateur d’appareil pour la classe d’appareil spécifiée associée à la ligne, à l’adresse ou à l’appel sélectionnés.

Syntaxe

LONG lineGetIDA(
  HLINE       hLine,
  DWORD       dwAddressID,
  HCALL       hCall,
  DWORD       dwSelect,
  LPVARSTRING lpDeviceID,
  LPCSTR      lpszDeviceClass
);

Paramètres

hLine

Gérer sur un appareil en ligne ouverte.

dwAddressID

Adresse sur l’appareil de ligne ouverte donné. Un identificateur d’adresse est associé définitivement à une adresse ; l’identificateur reste constant entre les mises à niveau du système d’exploitation.

hCall

Gérer un appel.

dwSelect

Spécifie si l’identificateur d’appareil demandé est associé à la ligne, à l’adresse ou à un seul appel. Ce paramètre utilise une et une seule des constantes LINECALLSELECT_.

lpDeviceID

Pointeur vers un emplacement de mémoire de type VARSTRING, où l’identificateur de l’appareil est retourné. Une fois la requête 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 l’API de classe d’appareil pour nommer des appareils. Avant d’appeler lineGetID, l’application doit définir le membre dwTotalSize de cette structure pour indiquer la quantité de mémoire disponible pour TAPI pour retourner des informations.

Remarque Si les paramètres de taille de la structure ne sont pas corrects, il est possible que les données puissent être remplacées. Pour plus d’informations sur la définition des tailles de structure, consultez la rubrique l’allocation de mémoire.

 

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 le SYSTÈME. Section INI pour identifier les classes d’appareil.

Valeur de retour

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 :

LINEERR_INVALLINEHANDLE, LINEERR_NOMEM, LINEERR_INVALADDRESSID, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALCALLHANDLE, LINEERR_OPERATIONFAILED, LINEERR_INVALCALLSELECT, LINEERR_INVALDEVICECLASS, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALPOINTER, LINEERR_STRUCTURETOOSMALL, LINEERR_NODEVICE, LINEERR_UNINITIALIZED.

Remarques

La fonction lineGetID peut être utilisée pour récupérer un identificateur d’appareil de ligne lorsqu’un handle de ligne est donné. Cela est utile après lineOpen a été ouvert à l’aide de LINEMAPPER en tant qu’identificateur d’appareil afin de déterminer l’identificateur réel de l’appareil de ligne de la ligne ouverte. Cette fonction peut également être utilisée pour obtenir l’identificateur d’appareil d’un appareil téléphonique ou d’un appareil multimédia (pour les classes d’appareil telles que COM, wave, MIDI, phone, line ou NDIS) associées à un appel, une adresse ou une ligne. Cet identificateur peut ensuite être utilisé avec l’API appropriée (par exemple, téléphone, MIDI, vague) pour sélectionner l’appareil multimédia correspondant associé à l’appel spécifié.

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

Un fournisseur qui définit un mode multimédia spécifique à l’appareil doit également définir l’API spécifique à l’appareil (propriétaire) correspondante pour gérer les appareils du mode multimédia. Pour éviter les collisions sur les noms de classes d’appareil 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 ».

Note

L’en-tête tapi.h définit lineGetID comme alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Exigences

Exigence	Valeur
plateforme cible	Windows
d’en-tête	tapi.h
bibliothèque	Tapi32.lib
DLL	Tapi32.dll

Voir aussi

Informations de référence sur les services de téléphonie de base

vue d’ensemble des informations de référence sur TAPI 2.2

VARSTRING

lineOpen