lineGetDevCaps

9/19/2008

Essa função consulta um dispositivo de linha especificado para determinar seus recursos telefonia. Os dados retornados é válido para todos os endereços no dispositivo de linha.

Syntax

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

Parameters

• hLineApp
  [no] Identificador para registro do aplicativo com TAPI.

• dwDeviceID
  [no] Identificador do dispositivo de linha a ser consultado.

• dwAPIVersion
  [no] Número Versão de TAPI a ser usado. O alto-ordem palavra contém o número versão principal; a baixa-ordem palavra contém o número versão secundária. Esse número é obtido usando o lineNegotiateAPIVersion função.

• dwExtVersion
  [no] Não com suporte; definido como zero.

• lpLineDevCaps
  [out] Ponteiro para uma variável dimensionados estrutura de tipo LINEDEVCAPS. Após bem-sucedido conclusão a solicitação, essa estrutura é preenchida com dados recursos dispositivo de linha. Prior to chamado lineGetDevCaps, o aplicativo deve definir a dwTotalSize membro dessa estrutura para indicar o disponível quantidade de memória para TAPI para retornar dados.

Return Value

Zero indica sucesso. Um número de erro negativa indica que ocorreu um erro. A seguinte tabela mostra os valores de retorno para esta função.

Valor	Descrição
LINEERR_BADDEVICEID	ID dispositivo incorreto fornecido
LINEERR_INCOMPATIBLEAPIVERSION	API versão é incompatível
LINEERR_INCOMPATIBLEEXTVERSION	Versão de extensão é incompatível
LINEERR_INVALAPPHANDLE	Identificador inválido
LINEERR_INVALPOINTER	Ponteiro inválido
LINEERR_NODEVICE	Nenhum dispositivo foi encontrado
LINEERR_NODRIVER	Nenhum driver foi encontrado
LINEERR_NOMEM	Nenhuma memória está disponível
LINEERR_OPERATIONFAILED	A operação falhou
LINEERR_OPERATIONUNAVAIL	A operação é não disponível
LINEERR_RESOURCEUNAVAIL	O recurso não está disponível
LINEERR_STRUCTURETOOSMALL	A estrutura é muito pequena
LINEERR_UNINITIALIZED	O parâmetro é não inicializado

Remarks

Antes de usar lineGetDevCaps, o aplicativo deve negociar o versão TAPI usar e, se desejar, a versão extensão usar.

Números de versão TAPI e extensão são aquelas em que TAPI e provedor de serviço devem operar. Se versão intervalos não sobreposição, o aplicativo, TAPI ou serviço-provedor versões são incompatível e um erro será retornado.

Uma dos membros na LINEDEVCAPS estrutura retornada por essa função contém o número de endereços atribuídos para o dispositivo de linha especificado. O real identificadores endereço usados para fazer referência individual endereços variam de zero por meio de um menor do que o número retornado. Os recursos de cada endereço podem ser diferentes. Use o lineGetAddressCaps função de cada disponível <dwDeviceID, dwAddressID> combinação para determinar os recursos de cada endereço exatos.

Requirements

Header	tapi.h
Library	coredll.lib
Windows Embedded CE	Windows CE 1.0 and later
Windows Mobile	Windows Mobile Version 5.0 and later

See Also

Reference

lineGetAddressCaps
lineNegotiateAPIVersion
LINEDEVCAPS