função TSPI_lineGetAddressCaps (tspi.h)

  • Artigo

A função TSPI_lineGetAddressCaps consulta o endereço especificado no dispositivo de linha especificado para determinar seus recursos de telefonia.

Sintaxe

LONG TSPIAPI TSPI_lineGetAddressCaps(
  DWORD             dwDeviceID,
  DWORD             dwAddressID,
  DWORD             dwTSPIVersion,
  DWORD             dwExtVersion,
  LPLINEADDRESSCAPS lpAddressCaps
);

Parâmetros

dwDeviceID

O dispositivo de linha que contém o endereço a ser consultado.

dwAddressID

O endereço no dispositivo de linha especificado cujos recursos devem ser consultados. Um identificador de endereço está permanentemente associado a um endereço; o identificador permanece constante entre as atualizações do sistema operacional. Esse parâmetro não é validado pelo TAPI quando essa função é chamada.

dwTSPIVersion

O número de versão do SPI de telefonia a ser usado. 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.

dwExtVersion

O número de versão das extensões específicas do provedor de serviços a serem usadas. Esse número será 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. Esse parâmetro não é validado pelo TAPI quando essa função é chamada.

lpAddressCaps

Um ponteiro para uma estrutura de tamanho variável do tipo LINEADDRESSCAPS. Após a conclusão bem-sucedida da solicitação, essa estrutura é preenchida com informações de funcionalidades de endereço.

Retornar valor

Retornará zero se a função for bem-sucedida ou um número de erro se ocorrer um erro. Os possíveis valores retornados são os seguintes:

LINEERR_INCOMPATIBLEAPIVERSION, LINEERR_NOMEM, LINEERR_INCOMPATIBLEEXTVERSION, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALADDRESSID, LINEERR_OPERATIONFAILED, LINEERR_NODRIVER, LINEERR_RESOURCEUNAVAIL.

Comentários

Os identificadores de dispositivo de linha compatíveis com um driver específico são numerados sequencialmente, começando com o valor de dwLineDeviceIDBase que é passado para a função TSPI_providerInit .

O provedor de serviços preenche todos os membros da estrutura de dados LINEADDRESSCAPS , exceto dwTotalSize, que é preenchida pelo TAPI. O provedor de serviços não deve substituir o membro dwTotalSize .

Depois que o provedor de serviços retorna da função TSPI_lineGetAddressCaps , TAPI define os membros dwCallInfoStates e dwCallStates da estrutura LINEADDRESSCAPS da seguinte maneira:

LINEADDRESSCAPS.dwCallInfoStates |=
    LINECALLINFOSTATE_NUMOWNERINCR |
    LINECALLINFOSTATE_NUMOWNERDECR |
    LINECALLINFOSTATE_NUMMONITORS;

LINEADDRESSCAPS.dwCallStates |= LINECALLSTATE_UNKNOWN;

Requisitos

Requisito Valor
Plataforma de Destino Windows
Cabeçalho tspi.h

Confira também

LINEADDRESSCAPS

Tspi_providerinit