Função lineGetDevCapsA (tapi.h)

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 lineGetDevCapsA(
  HLINEAPP      hLineApp,
  DWORD         dwDeviceID,
  DWORD         dwAPIVersion,
  DWORD         dwExtVersion,
  LPLINEDEVCAPS lpLineDevCaps
);

Parâmetros

hLineApp

Manipule 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 ordem baixa 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 ordem baixa contém o número de versão secundária.

lpLineDevCaps

Ponteiro para uma estrutura de tamanho variavelmente 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 dwTotalSize membro dessa estrutura para indicar a quantidade de memória disponível para TAPI para retornar informações.

Observação 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.

 

Valor de retorno

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.

Observações

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 de extensão a ser usada.

Os números de versão da API e da extensão são aqueles nos 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 serão incompatíveis e um erro será 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 fazer referência a 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, combinação de> 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 em atualizações do sistema operacional.

Nota

O cabeçalho tapi.h define lineGetDevCaps 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

LINEDEVCAPS

visão geral de referência do TAPI 2.2

lineGetAddressCaps

lineNegotiateAPIVersion

lineNegotiateExtVersion