lineSetCallQualityOfService 函数 (tapi.h)

项目
08/26/2023

lineSetCallQualityOfService 函数允许应用程序尝试更改服务参数的质量， (保留容量和性能保证) 现有调用。除基本参数验证外，这是直接传递到服务提供商。

语法

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

参数

hCall

调用的句柄。应用程序必须具有 OWNER 特权。

lpSendingFlowspec

指向包含 FLOWSPEC 结构的内存的指针，后跟提供程序特定的数据。 FLOWSPEC 结构后面的提供程序特定部分不得包含指向应用程序进程中其他内存块的指针，因为 TAPI 不知道如何封送专用指针 () 所指向的数据，并通过进程间通信将其传达给服务提供商。

dwSendingFlowspecSize

FLOWSPEC 结构和随附的提供程序特定数据的总大小（以字节为单位）。这相当于在 QOS 结构中存储在 SendingFlowspec 中的内容。

lpReceivingFlowspec

指向包含 FLOWSPEC 结构的内存的指针，后跟提供程序特定的数据。 FLOWSPEC 结构后面的提供程序特定部分不得包含指向应用程序进程中其他内存块的指针，因为 TAPI 不知道如何封送专用指针 () 所指向的数据，并通过进程间通信将其传达给服务提供商。

dwReceivingFlowspecSize

FLOWSPEC 和随附的提供程序特定数据的总大小（以字节为单位）。这相当于在 QOS 结构中存储在 ReceivingFlowspec 中的内容。

返回值

如果异步操作开始，则返回正请求标识符;否则，函数将返回以下负错误值之一：

LINEERR_INVALCALLHANDLE、LINEERR_INVALCALLSTATE、LINEERR_INVALPARAM、LINEERR_INVALPOINTER、LINEERR_INVALRATE、LINEERR_NOMEM、LINEERR_NOTOWNER、LINEERR_OPERATIONUNAVAIL、LINEERR_OPERATIONFAILED、LINEERR_RATEUNAVAIL、LINEERR_RESOURCEUNAVAIL、LINEERR_UNINITIALIZED。