função TSPI_lineGetDevCaps (tspi.h)
A função TSPI_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 TSPIAPI TSPI_lineGetDevCaps(
DWORD dwDeviceID,
DWORD dwTSPIVersion,
DWORD dwExtVersion,
LPLINEDEVCAPS lpLineDevCaps
);
Parâmetros
dwDeviceID
O dispositivo de linha a ser consultado.
dwTSPIVersion
O número de versão do TSPI negociado. Esse valor já foi negociado para esse dispositivo por meio da função TSPI_lineNegotiateTSPIVersion .
dwExtVersion
O número de versão da extensão negociada. Esse valor já foi negociado para esse dispositivo por meio da função TSPI_lineNegotiateExtVersion . Esse parâmetro não é validado pelo TAPI quando essa função é chamada.
lpLineDevCaps
Um 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.
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_OPERATIONUNAVAIL, LINEERR_INCOMPATIBLEEXTVERSION, LINEERR_OPERATIONFAILED, LINEERR_NODRIVER, LINEERR_RESOURCEUNAVAIL, LINEERR_NOMEM.
Comentários
A numeração do identificador de dispositivo de linha para um provedor de serviços é sequencial do valor definido pelo parâmetro dwLineDeviceIDBase que é passado para a função TSPI_providerInit .
O parâmetro formal dwExtVersion indica o número de versão das informações de extensão solicitadas. Se for zero, nenhuma informação de extensão será solicitada. Se não for zero, ele conterá um valor que foi negociado para esse dispositivo com a função TSPI_lineNegotiateExtVersion . O provedor de serviços preenche informações estendidas específicas do dispositivo e do fornecedor de acordo com a versão de extensão especificada.
O provedor de serviços preenche todos os membros da estrutura de dados LINEDEVCAPS , exceto dwTotalSize, que é preenchido pelo TAPI. O provedor de serviços não deve substituir o membro dwTotalSize .
O provedor de serviços deve preencher todos os membros da estrutura de dados LINETERMCAPS ou estruturas inseridas na parte variável da estrutura de dados LINEDEVCAPS .
Depois que o provedor de serviços retorna da função TSPI_lineGetDevCaps , o TAPI define o membro dwLinesStates da estrutura LINEDEVCAPS da seguinte maneira:
LINEDEVCAPS.dwLineStates |=
LINEDEVSTATE_OPEN |
LINEDEVSTATE_CLOSE |
LINEDEVSTATE_REINIT |
LINEDEVSTATE_TRANSLATECHANGE;
Requisitos
| Requisito | Valor |
|---|---|
| Plataforma de Destino | Windows |
| Cabeçalho | tspi.h |