função TSPI_phoneNegotiateTSPIVersion (tspi.h)
A função TSPI_phoneNegotiateTSPIVersion 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_phoneNegotiateTSPIVersion(
DWORD dwDeviceID,
DWORD dwLowVersion,
DWORD dwHighVersion,
LPDWORD lpdwTSPIVersion
);
Parâmetros
dwDeviceID
O dispositivo de telefone para o qual a negociação de versão da interface deve ser executada. Os valores permitidos estão estritamente dentro do intervalo de identificadores de dispositivos de telefone para esse provedor de serviços; o valor INITIALIZE_NEGOTIATION nunca é passado para essa função.
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. Após um retorno bem-sucedido dessa função, o provedor de serviços preenche esse local com o número de versão mais alto do TSPI, 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 do provedor de serviços, a função retornará PHONEERR_INCOMPATIBLEAPIVERSION.
Valor retornado
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:
PHONEERR_INCOMPATIBLEAPIVERSION, PHONEERR_RESOURCEUNAVAIL, PHONEERR_NODRIVER, PHONEERR_OPERATIONFAILED, PHONEERR_NOMEM, PHONEERR_OPERATIONUNAVAIL.
Comentários
O provedor de serviços retornará PHONEERR_OPERATIONUNAVAIL se a operação não estiver disponível. No entanto, se o provedor de serviços der suporte a dispositivos de telefone, ele também deverá dar suporte a essa função e a função não deverá retornar PHONEERR_OPERATIONUNAVAIL.
O TAPI chama essa função no início da sequência de inicialização para cada dispositivo de telefone.
A negociação de uma versão de extensão é feita por meio do procedimento separado TSPI_phoneNegotiateExtVersion.
A função correspondente no nível TAPI é uma função sobrecarregada que também recupera o identificador de extensão, se houver, compatível com o provedor de serviços. No nível do TSPI, a recuperação do identificador de extensão é realizada por meio de um procedimento separado, ou seja, TSPI_phoneGetExtensionID.
Requisitos
| Plataforma de Destino | Windows |
| Cabeçalho | tspi.h |