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