Función lineSetCallQualityOfService (tapi.h)

La función lineSetCallQualityOfService permite a la aplicación intentar cambiar la calidad de los parámetros de servicio (garantías reservadas de capacidad y rendimiento) para una llamada existente. Excepto para la validación básica de parámetros, se trata de un paso directo a un proveedor de servicios.

Sintaxis

LONG lineSetCallQualityOfService(
  HCALL  hCall,
  LPVOID lpSendingFlowspec,
  DWORD  dwSendingFlowspecSize,
  LPVOID lpReceivingFlowspec,
  DWORD  dwReceivingFlowspecSize
);

Parámetros

hCall

Identificador de la llamada. La aplicación debe tener el privilegio OWNER.

lpSendingFlowspec

Puntero a la memoria que contiene una estructura FLOWSPEC seguida de datos específicos del proveedor. La parte específica del proveedor que sigue a la estructura FLOWSPEC no debe contener punteros a otros bloques de memoria en el proceso de aplicación, ya que TAPI no sabrá serializar los datos a los que apuntan los punteros privados y transmitirlos a través de la comunicación entre procesos al proveedor de servicios.

dwSendingFlowspecSize

Tamaño total de la estructura FLOWSPEC y datos específicos del proveedor adjuntos, en bytes. Esto equivale a lo que se habría almacenado en SendingFlowspec en una estructura de QOS .

lpReceivingFlowspec

Puntero a la memoria que contiene una estructura FLOWSPEC seguida de datos específicos del proveedor. La parte específica del proveedor que sigue a la estructura FLOWSPEC no debe contener punteros a otros bloques de memoria en el proceso de aplicación, ya que TAPI no sabrá serializar los datos a los que apuntan los punteros privados y transmitirlos a través de la comunicación entre procesos al proveedor de servicios.

dwReceivingFlowspecSize

Tamaño total de FLOWSPEC y datos específicos del proveedor adjuntos, en bytes. Esto equivale a lo que se habría almacenado en ReceiveingFlowspec en una estructura QOS .

Valor devuelto

Devuelve un identificador de solicitud positivo si se inicia la operación asincrónica; de lo contrario, la función devuelve uno de estos valores de error 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
Encabezado	tapi.h
Library	Tapi32.lib
Archivo DLL	Tapi32.dll

Consulte también

FLOWSPEC

QOS

Funciones de servicio de línea complementarias

Información general de referencia de TAPI 2.2