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