função TSPI_lineSelectExtVersion (tspi.h)

  • Artigo

A função TSPI_lineSelectExtVersion seleciona a versão de extensão indicada para o dispositivo de linha indicado. As solicitações subsequentes operam de acordo com essa versão de extensão.

Sintaxe

LONG TSPIAPI TSPI_lineSelectExtVersion(
  HDRVLINE hdLine,
  DWORD    dwExtVersion
);

Parâmetros

hdLine

O identificador para a linha para a qual uma versão de extensão deve ser selecionada.

dwExtVersion

A versão da extensão a ser selecionada. Esse número de versão foi negociado usando TSPI_lineNegotiateExtVersion. O WORD mais significativo é o número de versão principal e o WORD menos significativo é o número de versão secundária. Chamar essa função com um dwExtVersion de zero cancela a seleção atual.

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_INCOMPATIBLEEXTVERSION, LINEERR_OPERATIONFAILED, LINEERR_NOMEM, LINEERR_RESOURCEUNAVAIL, LINEERR_OPERATIONUNAVAIL.

Comentários

O provedor de serviços seleciona a versão de extensão indicada. Embora o número de versão indicado possa ter sido negociado com êxito, uma versão de extensão diferente pode ter sido selecionada nesse ínterim, caso em que essa função falha (retornando LINEERR_INCOMPATIBLEEXTVERSION).

As operações subsequentes na linha após a seleção de uma versão de extensão se comportam de acordo com essa versão de extensão. Tentativas subsequentes de negociar o relatório de versão da extensão estritamente a versão ou 0 selecionada (se o intervalo solicitado não incluir a versão selecionada). Chamar esse procedimento com a extensão especial versão 0 cancela a seleção atual. O dispositivo se torna mais uma vez capaz de dar suporte a sua gama completa de números de versão de extensão.

Essa função não tem correspondência direta no nível TAPI, em que a seleção de uma versão de extensão é agrupada com a outra funcionalidade de lineOpen. A função TSPI_lineSelectExtVersion normalmente é chamada em duas situações: (1) Um aplicativo solicitado a abrir uma linha, a alteração resultante do monitoramento de tipo de mídia foi bem-sucedida, o aplicativo solicitou que uma versão de extensão específica fosse usada e nenhuma versão de extensão foi selecionada no momento. (2) O último aplicativo usando uma versão de extensão específica fechou a linha e a seleção da versão da extensão pode ser cancelada.

Requisitos

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

Confira também

TSPI_lineNegotiateExtVersion