Função lineDevSpecificFeature (tapi.h)

Artigo
03/02/2024

A função lineDevSpecificFeature permite que os provedores de serviços forneçam acesso aos recursos não oferecidos por outras funções TAPI. O significado dessas extensões é específico do dispositivo e aproveitar essas extensões exige que o aplicativo esteja totalmente ciente delas.

Sintaxe

LONG lineDevSpecificFeature(
  HLINE  hLine,
  DWORD  dwFeature,
  LPVOID lpParams,
  DWORD  dwSize
);

Parâmetros

hLine

Identificador para o dispositivo de linha.

dwFeature

Recurso a ser invocado no dispositivo de linha. Esse parâmetro usa as constantes PHONEBUTTONFUNCTION_.

lpParams

Ponteiro para uma área de memória usada para conter um bloco de parâmetro dependente de recursos. O formato desse bloco de parâmetros é específico do dispositivo e seu conteúdo é passado por TAPI para ou do provedor de serviços.

dwSize

Tamanho do buffer, em bytes.

Retornar valor

Retorna um identificador de solicitação positivo se a função for concluída de forma assíncrona ou um número de erro negativo se ocorrer um erro. O parâmetro dwParam2 da mensagem de LINE_REPLY correspondente será zero se a função for bem-sucedida ou se for um número de erro negativo se ocorrer um erro. Os valores retornados possíveis são:

LINEERR_INVALFEATURE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALLINEHANDLE, LINEERR_OPERATIONFAILED, LINEERR_INVALPOINTER, LINEERR_RESOURCEUNAVAIL, LINEERR_NOMEM, LINEERR_UNINITIALIZED.

Valores retornados adicionais são específicos do dispositivo.

Comentários

Essa operação faz parte dos serviços de Telefonia Estendida. Ele fornece acesso a um recurso específico do dispositivo sem definir seu significado. Essa operação só estará disponível se o aplicativo tiver negociado com êxito uma versão de extensão específica do dispositivo.

Essa função fornece ao aplicativo recursos de emulação de botão de recurso do telefone. Quando um aplicativo invoca essa operação, ele especifica o equivalente a um evento de pressionamento de botão. Esse método de invocação de recursos depende do dispositivo, pois o TAPI não define seu significado. Normalmente, um aplicativo que depende dessas extensões específicas do dispositivo não funciona com outros ambientes do provedor de serviços.

A estrutura apontada por lpParams não deve conter ponteiros porque eles não seriam convertidos corretamente (conversão) ao executar um aplicativo de 16 bits em uma versão de 32 bits do TAPI e vice-versa.