Função lineGetDevCaps (tapi.h)

Artigo
08/26/2023

A função lineGetDevCaps consulta um dispositivo de linha especificado para determinar seus recursos de telefonia. As informações retornadas são válidas para todos os endereços no dispositivo de linha.

Sintaxe

LONG lineGetDevCaps(
  HLINEAPP      hLineApp,
  DWORD         dwDeviceID,
  DWORD         dwAPIVersion,
  DWORD         dwExtVersion,
  LPLINEDEVCAPS lpLineDevCaps
);

Parâmetros

hLineApp

Manipule para o registro do aplicativo com TAPI.

dwDeviceID

Identificador do dispositivo de linha a ser consultado.

dwAPIVersion

Número de versão da API de Telefonia a ser usada. A palavra de alta ordem contém o número de versão principal; a palavra de baixa ordem contém o número de versão secundária. Esse número é obtido por lineNegotiateAPIVersion.

dwExtVersion

Número de versão das extensões específicas do provedor de serviços a serem usadas. Esse número é obtido por lineNegotiateExtVersion. Ele poderá ser deixado zero se nenhuma extensão específica do dispositivo for usada. Caso contrário, a palavra de alta ordem contém o número de versão principal; a palavra de baixa ordem contém o número de versão secundária.

lpLineDevCaps

Ponteiro para uma estrutura de tamanho variável do tipo LINEDEVCAPS. Após a conclusão bem-sucedida da solicitação, essa estrutura é preenchida com informações de funcionalidades do dispositivo de linha. Antes de chamar lineGetDevCaps, o aplicativo deve definir o membro dwTotalSize dessa estrutura para indicar a quantidade de memória disponível para TAPI para retornar informações.

Nota Se os parâmetros de tamanho na estrutura não estiverem corretos, há a possibilidade de que os dados possam ser substituídos. Para obter mais informações sobre como definir tamanhos de estrutura, consulte o tópico alocação de memória .

Retornar valor

Retornará zero se a solicitaçã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_NOMEM, LINEERR_INCOMPATIBLEAPIVERSION, LINEERR_OPERATIONFAILED, LINEERR_INCOMPATIBLEEXTVERSION, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALAPPHANDLE, LINEERR_STRUCTURETOOSMALL, LINEERR_INVALPOINTER, LINEERR_UNINITIALIZED, LINEERR_NODRIVER, LINEERR_OPERATIONUNAVAIL, LINEERR_NODEVICE.

Comentários

Antes de usar lineGetDevCaps, o aplicativo deve negociar o número de versão da API a ser usado e, se desejado, a versão da extensão a ser usada.

Os números de versão da API e da extensão são aqueles sob os quais o TAPI e o provedor de serviços devem operar. Se os intervalos de versão não se sobrepõem, as versões do aplicativo, da API ou do provedor de serviços são incompatíveis e um erro é retornado.

Um dos membros na estrutura LINEDEVCAPS retornada por essa função contém o número de endereços atribuídos ao dispositivo de linha especificado. Os identificadores de endereço reais usados para referenciar endereços individuais variam de zero a um a menos do que o número retornado. Os recursos de cada endereço podem ser diferentes. Use lineGetAddressCaps para cada dwDeviceID disponível<, a combinação dwAddressID> para determinar os recursos exatos de cada endereço. Observe que um identificador de endereço está permanentemente associado a um endereço; o identificador permanece constante entre as atualizações do sistema operacional.