fonction lineGetID (tapi.h)

Article
08/26/2023

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 lineGetID(
  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é de façon permanente à 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 appel unique. Ce paramètre utilise 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 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 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.

Note Si les paramètres de taille de la structure ne sont pas corrects, il est possible que les données soient remplacées. Pour plus d’informations sur la définition des tailles de structure, consultez la rubrique 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 la section SYSTEM.INI pour identifier les classes d’appareils.

Valeur retournée

Retourne zéro si la requête réussit ou un numéro d’erreur négatif si une erreur 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 de périphérique de ligne lorsqu’un handle de ligne est donné. Cela est utile une fois que lineOpen a été ouvert à l’aide de LINEMAPPER comme identificateur d’appareil afin de déterminer l’identificateur de ligne réel de l’appareil 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, téléphone, ligne 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, onde) pour sélectionner le périphérique multimédia correspondant associé à l’appel spécifié.

Consultez Classes d’appareils TAPI pour les noms de classes d’appareils.

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