função TSPI_lineSetCallQualityOfService (tspi.h)

  • Artigo

O provedor de serviços de funções TSPI_lineSetCallQualityOfService tenta renegociar o QOS na chamada com a opção Se o QOS desejado não estiver disponível, a função falhará, mas a chamada continuará com o QOS anterior. Se a função for bem-sucedida, as novas informações de QOS serão armazenadas em LINECALLINFO; uma mensagem LINECALLINFOSTATE_QOS é enviada pelo provedor de serviços para indicar os valores atualizados.

Sintaxe

LONG TSPIAPI TSPI_lineSetCallQualityOfService(
  DRV_REQUESTID dwRequestID,
  HDRVCALL      hdCall,
  LPVOID        lpSendingFlowspec,
  DWORD         dwSendingFlowspecSize,
  LPVOID        lpReceivingFlowspec,
  DWORD         dwReceivingFlowspecSize
);

Parâmetros

dwRequestID

Identificador para relatar resultados de função assíncrona.

hdCall

O identificador do provedor de serviços para a chamada.

lpSendingFlowspec

Ponteiro para a memória que contém uma estrutura WINSock2 FLOWSPEC seguida por dados específicos do provedor. A parte específica do provedor que segue a estrutura FLOWSPEC não deve conter ponteiros para outros blocos de memória no processo do aplicativo, pois o TAPI não sabe como realizar marshaling dos dados apontados pelos ponteiros privados e transmiti-los por meio da comunicação entre processos para o provedor de serviços.

dwSendingFlowspecSize

O tamanho total em bytes do FLOWSPEC e os dados específicos do provedor que acompanham, equivalente ao que teria sido armazenado em SendingFlowspec.len em uma estrutura de QOS WinSock2.

lpReceivingFlowspec

Ponteiro para a memória que contém uma estrutura WINSock2 FLOWSPEC seguida por dados específicos do provedor. A parte específica do provedor que segue a estrutura FLOWSPEC não deve conter ponteiros para outros blocos de memória no processo do aplicativo, pois o TAPI não sabe como realizar marshaling dos dados apontados pelos ponteiros privados e transmiti-los por meio da comunicação entre processos para o provedor de serviços.

dwReceivingFlowspecSize

O tamanho total em bytes do FLOWSPEC e os dados específicos do provedor que acompanham, equivalentes ao que teria sido armazenado em ReceivingFlowspec.len em uma estrutura do QOS WinSock2.

Retornar valor

Retorna dwRequestID se a operação assíncrona for iniciada; caso contrário, a função retornará um destes valores de erro negativos:

LINEERR_INVALCALLSTATE, LINEERR_INVALRATE, LINEERR_NOMEM, LINEERR_OPERATIONFAILED, LINEERR_RATEUNAVAIL, LINEERR_RESOURCEUNAVAIL.

Requisitos

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

Confira também

LINECALLINFO