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 |