Função lineSetCallQualityOfService (tapi.h)

Artigo
08/26/2023

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.