Função lineDevSpecificFeature (tapi.h)
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.
Requisitos
| Requisito | Valor |
|---|---|
| Plataforma de Destino | Windows |
| Cabeçalho | tapi.h |
| Biblioteca | Tapi32.lib |
| DLL | Tapi32.dll |