fonction lineSetDevConfig (tapi.h)

Article
08/26/2023

La fonction lineSetDevConfig permet à l’application de restaurer la configuration d’un périphérique 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 des caractères, les schémas de modulation et les paramètres de protocole de contrôle d’erreur pour un périphérique multimédia « datamodem » associé à la ligne.

Syntaxe

LONG lineSetDevConfig(
  DWORD        dwDeviceID,
  LPVOID const lpDeviceConfig,
  DWORD        dwSize,
  LPCSTR       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 vers lpDeviceConfig. Cette valeur est retournée dans le membre dwStringSize de la structure VARSTRING renvoyé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 les mêmes que celles spécifiées pour la fonction lineGetID .

Valeur retournée

Retourne zéro si la fonction réussit ou un numéro d’erreur négatif si une erreur 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 annuaire téléphonique 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, lineConfigDialog et 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 ligne et de flux multimé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 le contenu directement. 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. Certains fournisseurs de services de téléphonie peuvent toutefois autoriser l’échange de structures entre des appareils identiques (c’est-à-dire plusieurs ports sur le même modem multiport carte). Cette interchangeabilité n’est garantie en aucune façon, même pour les appareils de la même classe d’appareil.

Certains fournisseurs de services peuvent autoriser la configuration à être définie pendant qu’un appel est actif, et d’autres non.