Função lineDevSpecific (tapi.h)

Artigo
08/26/2023

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

Sintaxe

LONG lineDevSpecific(
  HLINE  hLine,
  DWORD  dwAddressID,
  HCALL  hCall,
  LPVOID lpParams,
  DWORD  dwSize
);

Parâmetros

hLine

Identificador para um dispositivo de linha. Este parâmetro é necessário.

dwAddressID

Identificador de endereço no dispositivo de linha especificado. Um identificador de endereço está permanentemente associado a um endereço; o identificador permanece constante entre as atualizações do sistema operacional.

hCall

Manipule para uma chamada. Esse parâmetro é opcional, mas se for especificado, a chamada que ele representa deverá pertencer ao dispositivo de linha hLine . O estado de chamada de hCall é específico do dispositivo.

lpParams

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

dwSize

Tamanho da área do bloco de parâmetros, em bytes.

Valor retornado

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_INVALADDRESSID, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALCALLHANDLE, LINEERR_OPERATIONFAILED, LINEERR_INVALLINEHANDLE, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALPOINTER, LINEERR_UNINITIALIZED, LINEERR_NOMEM.

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 um perfil de parâmetro genérico. A interpretação da estrutura de parâmetros é específica do dispositivo. Se dwAddressID e/ou hCall devem ser válidos é específico do dispositivo. Se especificado, eles devem pertencer a hLine. As indicações e respostas enviadas de volta ao aplicativo que são específicas do dispositivo devem usar a mensagem LINE_DEVSPECIFIC .

Um provedor de serviços pode fornecer acesso a funções específicas do dispositivo definindo parâmetros para uso com essa função. Os aplicativos que desejam usar essas extensões específicas do dispositivo devem consultar a documentação específica do dispositivo (nesse caso, específica do fornecedor) que descreve quais extensões são definidas. Normalmente, um aplicativo que depende dessas extensões específicas do dispositivo não é capaz de trabalhar com outros ambientes do provedor de serviços.

Cuidado O TAPI gravará os dados retornados no buffer referenciado por lParam quando a mensagem LINE_REPLY for retornada. Isso significa que o buffer deve permanecer válido até que a mensagem LINE_REPLY seja retornada; caso contrário, dados corrompidos e exceções podem ocorrer.