função TSPI_lineGetAddressCaps (tspi.h)
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 |