Função lineSetDevConfigW (tapi.h)

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 taxa de dados, formato de caractere, esquemas de modulação e configurações de protocolo de controle de erro para um dispositivo de mídia "datamodem" associado à linha.

Sintaxe

LONG lineSetDevConfigW(
  DWORD        dwDeviceID,
  LPVOID const lpDeviceConfig,
  DWORD        dwSize,
  LPCWSTR      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. As cadeias de caracteres de classe de dispositivo válidas são as mesmas especificadas para a função lineGetID.

Valor de retorno

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.

Observações

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 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 pode ser usada para restaurar as configurações selecionadas pelo usuário. As funçõeslineSetDevConfig , lineConfigDialoge 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 cartão de modem multiport). 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.

Nota

O cabeçalho tapi.h define lineSetDevConfig como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito	Valor
da Plataforma de Destino	Windows
cabeçalho	tapi.h
biblioteca	Tapi32.lib
de DLL	Tapi32.dll

Consulte também

Referência dos Serviços básicos de telefonia

visão geral de referência do TAPI 2.2

VARSTRING

lineConfigDialog

lineGetDevConfig

lineGetID