Função lineSetCallQualityOfService (tapi.h)
A função lineSetCallQualityOfService permite que o aplicativo tente alterar a qualidade dos parâmetros de serviço (capacidade reservada e garantias de desempenho) para uma chamada existente. Exceto para validação de parâmetro básico, essa é uma passagem direta para um provedor de serviços.
Sintaxe
LONG lineSetCallQualityOfService(
HCALL hCall,
LPVOID lpSendingFlowspec,
DWORD dwSendingFlowspecSize,
LPVOID lpReceivingFlowspec,
DWORD dwReceivingFlowspecSize
);
Parâmetros
hCall
Manipule para a chamada. O aplicativo deve ter privilégio OWNER.
lpSendingFlowspec
Ponteiro para a memória que contém uma estrutura 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 saberá 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
Tamanho total da estrutura FLOWSPEC e dos dados específicos do provedor, em bytes. Isso é equivalente ao que teria sido armazenado em SendingFlowspec em uma estrutura QOS .
lpReceivingFlowspec
Ponteiro para a memória que contém uma estrutura 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 saberá 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
Tamanho total do FLOWSPEC e dos dados específicos do provedor, em bytes. Isso é equivalente ao que teria sido armazenado em ReceivingFlowspec em uma estrutura QOS .
Valor retornado
Retorna um identificador de solicitação positivo se a operação assíncrona for iniciada; caso contrário, a função retornará um destes valores de erro negativos:
LINEERR_INVALCALLHANDLE, LINEERR_INVALCALLSTATE, LINEERR_INVALPARAM, LINEERR_INVALPOINTER, LINEERR_INVALRATE, LINEERR_NOMEM, LINEERR_NOTOWNER, LINEERR_OPERATIONUNAVAIL, LINEERR_OPERATIONFAILED, LINEERR_RATEUNAVAIL, LINEERR_RESOURCEUNAVAIL, LINEERR_UNINITIALIZED.
Requisitos
| Plataforma de Destino | Windows |
| Cabeçalho | tapi.h |
| Biblioteca | Tapi32.lib |
| DLL | Tapi32.dll |