Função lineSetDevConfig (tapi.h)

Artigo
03/05/2024

A função lineSetDevConfig permite que o aplicativo restaure a configuração de um dispositivo de fluxo de mídia em um dispositivo de linha para uma configuração obtida anteriormente usando lineGetDevConfig. Por exemplo, o conteúdo dessa estrutura pode especificar a taxa de dados, o formato de caractere, os esquemas de modulação e as configurações do protocolo de controle de erro para um dispositivo de mídia "datamodem" associado à linha.

Sintaxe

LONG lineSetDevConfig(
  DWORD        dwDeviceID,
  LPVOID const lpDeviceConfig,
  DWORD        dwSize,
  LPCSTR       lpszDeviceClass
);

Parâmetros

dwDeviceID

Identificador do dispositivo de linha a ser configurado.

lpDeviceConfig

Ponteiro para a estrutura de dados de configuração opaca que foi retornada por lineGetDevConfig na parte variável da estrutura VARSTRING .

dwSize

Número de bytes na estrutura apontada por lpDeviceConfig. Esse valor é retornado no membro dwStringSize na estrutura VARSTRING retornada por lineGetDevConfig.

lpszDeviceClass

Ponteiro para uma cadeia de caracteres terminada em nulo que especifica a classe de dispositivo do dispositivo cuja configuração deve ser definida. Cadeias de caracteres de classe de dispositivo válidas são as mesmas especificadas para a função lineGetID .

Retornar valor

Retornará zero se a função for bem-sucedida ou um número de erro negativo se ocorrer um erro. Os possíveis valores retornados são:

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

Comentários

Os estados de chamada são específicos do dispositivo.

Normalmente, um aplicativo chama lineGetID para identificar o dispositivo de fluxo de mídia associado a uma linha e, em seguida, chama lineConfigDialog para permitir que o usuário configure a configuração do dispositivo. Em seguida, ele pode chamar lineGetDevConfig e salvar as informações de configuração em uma lista telefônica ou em outro banco de dados associado a um destino de chamada específico. Quando o usuário quiser chamar o mesmo destino novamente, essa função lineSetDevConfig poderá ser usada para restaurar as configurações selecionadas pelo usuário. As funções lineSetDevConfig, lineConfigDialog e lineGetDevConfig podem ser usadas, nessa ordem, para permitir que o usuário exiba e atualize as configurações.

O formato exato dos dados contidos na estrutura é específico para a API de fluxo de linha e mídia (classe de dispositivo), não está documentado e é indefinido. O aplicativo deve tratá-lo como "opaco" e não manipular o conteúdo diretamente. Em geral, a estrutura pode ser enviada usando essa função apenas para o mesmo dispositivo do qual foi obtida. Determinados provedores de serviços de telefonia podem, no entanto, permitir que as estruturas sejam trocadas entre dispositivos idênticos (ou seja, várias portas no mesmo modem multiport cartão). Essa intercambiabilidade não é garantida de forma alguma, mesmo para dispositivos da mesma classe de dispositivo.

Alguns provedores de serviços podem permitir que a configuração seja definida enquanto uma chamada estiver ativa e outras não.