Compartilhar via


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

Confira também

LINEDEVCAPS

LINETERMCAPS

TSPI_lineNegotiateExtVersion

Tspi_linenegotiatetspiversion

Tspi_providerinit