TSPI_lineSetCallQualityOfService函数服务提供程序尝试使用开关重新协商调用上的 QOS 如果所需的 QOS 不可用,则函数会失败,但调用将继续使用以前的 QOS。 如果函数成功,则新的 QOS 信息将存储在 LINECALLINFO 中;服务提供程序发送LINECALLINFOSTATE_QOS消息以指示更新的值。
语法
LONG TSPIAPI TSPI_lineSetCallQualityOfService(
DRV_REQUESTID dwRequestID,
HDRVCALL hdCall,
LPVOID lpSendingFlowspec,
DWORD dwSendingFlowspecSize,
LPVOID lpReceivingFlowspec,
DWORD dwReceivingFlowspecSize
);
参数
dwRequestID
用于报告异步函数结果的标识符。
hdCall
服务提供商对调用的句柄。
lpSendingFlowspec
指向包含 WinSock2 FLOWSPEC 结构的内存的指针,后跟提供程序特定的数据。 FLOWSPEC 结构后面的特定于提供程序的部分不得包含指向应用程序进程中其他内存块的指针,因为 TAPI 不知道如何将专用指针指向的数据封送 () ,并通过进程间通信将其传达给服务提供商。
dwSendingFlowspecSize
FLOWSPEC 和随附的特定于提供程序的数据的总大小(以字节为单位),相当于 WinSock2 QOS 结构中在 SendingFlowspec.len 中存储的数据。
lpReceivingFlowspec
指向包含 WinSock2 FLOWSPEC 结构的内存的指针,后跟提供程序特定的数据。 FLOWSPEC 结构后面的特定于提供程序的部分不得包含指向应用程序进程中其他内存块的指针,因为 TAPI 不知道如何将专用指针指向的数据封送 () ,并通过进程间通信将其传达给服务提供商。
dwReceivingFlowspecSize
FLOWSPEC 和随附的特定于提供程序的数据的总大小(以字节为单位),相当于 WinSock2 QOS 结构中在 ReceivingFlowspec.len 中存储的数据。
返回值
如果异步操作启动,则返回 dwRequestID ;否则,函数将返回以下负错误值之一:
LINEERR_INVALCALLSTATE、LINEERR_INVALRATE、LINEERR_NOMEM、LINEERR_OPERATIONFAILED、LINEERR_RATEUNAVAIL、LINEERR_RESOURCEUNAVAIL。
要求
要求 | 值 |
---|---|
目标平台 | Windows |
标头 | tspi.h |