lineSetDevConfigW, fonction (tapi.h)

La fonction lineSetDevConfig permet à l’application de restaurer la configuration d’un appareil de flux multimédia sur un appareil de ligne sur une configuration obtenue précédemment à l’aide de lineGetDevConfig. Par exemple, le contenu de cette structure peut spécifier le débit de données, le format de caractères, les schémas de segmentation et les paramètres de protocole de contrôle d’erreur pour un périphérique multimédia « datamodem » associé à la ligne.

Syntaxe

LONG lineSetDevConfigW(
  DWORD        dwDeviceID,
  LPVOID const lpDeviceConfig,
  DWORD        dwSize,
  LPCWSTR      lpszDeviceClass
);

Paramètres

dwDeviceID

Identificateur de l’appareil de ligne à configurer.

lpDeviceConfig

Pointeur vers la structure de données de configuration opaque retournée par lineGetDevConfig dans la partie variable de la structure VARSTRING.

dwSize

Nombre d’octets dans la structure pointée par lpDeviceConfig. Cette valeur est retournée dans le membre dwStringSize dans la structure VARSTRING retournée par lineGetDevConfig.

lpszDeviceClass

Pointeur vers une chaîne terminée par null qui spécifie la classe d’appareil de l’appareil dont la configuration doit être définie. Les chaînes de classe d’appareil valides sont identiques à celles spécifiées pour la fonction lineGetID .

Valeur de retour

Retourne zéro si la fonction réussit ou si un numéro d’erreur négatif se produit. Les valeurs de retour possibles sont les suivantes :

LINEERR_BADDEVICEID, LINEERR_NODRIVER, LINEERR_INVALDEVICECLASS, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALPOINTER, LINEERR_OPERATIONFAILED, LINEERR_INVALPARAM, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALLINESTATE, LINEERR_UNINITIALIZED, LINEERR_NOMEM, LINEERR_NODEVICE.

Remarques

Les états d’appel sont spécifiques à l’appareil.

En règle générale, une application appelle lineGetID pour identifier l’appareil de flux multimédia associé à une ligne, puis appelle lineConfigDialog pour permettre à l’utilisateur de configurer la configuration de l’appareil. Il peut ensuite appeler lineGetDevConfig et enregistrer les informations de configuration dans un carnet de téléphone ou une autre base de données associée à une destination d’appel particulière. Lorsque l’utilisateur souhaite appeler à nouveau la même destination, cette fonction lineSetDevConfig peut être utilisée pour restaurer les paramètres de configuration sélectionnés par l’utilisateur. Les fonctions lineSetDevConfig, lineConfigDialoget lineGetDevConfig peuvent être utilisées, dans cet ordre, pour permettre à l’utilisateur d’afficher et de mettre à jour les paramètres.

Le format exact des données contenues dans la structure est spécifique à l’API de flux de ligne et de média (classe d’appareil), n’est pas documenté et n’est pas défini. L’application doit la traiter comme « opaque » et ne pas manipuler directement le contenu. En règle générale, la structure peut être envoyée à l’aide de cette fonction uniquement au même appareil à partir duquel elle a été obtenue. Toutefois, certains fournisseurs de services de téléphonie peuvent permettre l’échange de structures entre des appareils identiques (c’est-à-dire plusieurs ports sur la même carte de modem multiport). Cette interchangeabilité n’est garantie d’aucune façon, même pour les appareils de la même classe d’appareil.

Certains fournisseurs de services peuvent autoriser la configuration à définir pendant qu’un appel est actif, et d’autres peuvent ne pas le faire.

Note

L’en-tête tapi.h définit lineSetDevConfig 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

lineConfigDialog

lineGetDevConfig

lineGetID