Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
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