função TSPI_lineNegotiateTSPIVersion (tspi.h)

Artigo
03/03/2024

A função TSPI_lineNegotiateTSPIVersion retorna a versão spi mais alta em que o provedor de serviços pode operar para este dispositivo, considerando o intervalo de versões de SPI possíveis.

Sintaxe

LONG TSPIAPI TSPI_lineNegotiateTSPIVersion(
  DWORD   dwDeviceID,
  DWORD   dwLowVersion,
  DWORD   dwHighVersion,
  LPDWORD lpdwTSPIVersion
);

Parâmetros

dwDeviceID

Identifica o dispositivo de linha para o qual a negociação de versão da interface deve ser executada. Além dos identificadores de dispositivo dentro do intervalo ao qual o provedor de serviços dá suporte, esse pode ser o valor:

INITIALIZE_NEGOTIATION

Esse valor é usado para significar que uma versão geral da interface deve ser negociada.

dwLowVersion

O menor número de versão do TSPI no qual o TAPI pode operar. O WORD mais significativo é o número de versão principal e o WORD menos significativo é o número de versão secundária.

dwHighVersion

O número de versão mais alto do TSPI no qual o TAPI pode operar. O WORD mais significativo é o número de versão principal e o WORD menos significativo é o número de versão secundária.

lpdwTSPIVersion

Um ponteiro para um DWORD. O provedor de serviços preenche esse local com o número de versão de TSPI mais alto, dentro do intervalo solicitado pelo chamador, no qual o provedor de serviços pode operar. O WORD mais significativo é o número de versão principal e o WORD menos significativo é o número de versão secundária. Se o intervalo solicitado não sobrepor o intervalo com suporte pelo provedor de serviços, a função retornará LINEERR_INCOMPATIBLEAPIVERSION.

Retornar valor

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

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

Comentários

Quando dwDeviceID é INITIALIZE_NEGOTIATION, essa função não deve retornar LINEERR_OPERATIONUNAVAIL, pois essa função (com esse valor) é obrigatória para negociar a versão geral da interface, mesmo que o provedor de serviços não dê suporte a nenhum dispositivo de linha.