通过

QOSStopTrackingClient 函数 (qos2.h)

  • 项目

QOSStopTrackingClient 函数通知 QoS 子系统停止跟踪以前使用 QOSStartTrackingClient 函数的客户端。 如果流当前正在进行，则此函数不会影响它。

语法

ExternC BOOL QOSStopTrackingClient(
  [in] HANDLE    QOSHandle,
  [in] PSOCKADDR DestAddr,
       DWORD     Flags
);

参数

[in] QOSHandle

QOSCreateHandle 返回的 QOS 子系统的句柄。

[in] DestAddr

指向包含客户端设备的 IP 地址 的 sockaddr 结构的指针。 客户端由其 IP 地址和地址系列标识。 端口号不是必需的，将被忽略。

Flags

保留供将来使用。

返回值

如果该函数成功，则返回值为非零值。

如果函数失败，返回值为 0。 要获得更多的错误信息，请调用 GetLastError。 一些可能的错误代码随之而来。

返回代码 说明
ERROR_INVALID_HANDLE
 QOSHandle 参数无效。
ERROR_INVALID_PARAMETER
 DestAddr 参数无效。
ERROR_NOT_ENOUGH_MEMORY
 指示内存分配失败。
ERROR_NO_SYSTEM_RESOURCES
 资源不足，无法执行该操作。
ERROR_IO_DEVICE
 由于出现 I/O 设备错误，因此无法执行该请求。
ERROR_DEVICE_REINITIALIZATION_NEEDER
 由于硬件错误，指示的设备需要重新初始化。 应用程序应清理并再次调用 QOSCreateHandle 。
ERROR_ADAP_HDW_ERR
 网络适配器硬件出错。

注解

必须包含 Winsock2.h 头文件才能使用 Winsock 定义的标识符或函数。

示例

以下代码演示在应用程序设置中调用的此函数。 有关参数信息，请参阅 QOSStartTrackingClient 。

if(!QOSStopTrackingClient(QoSHandle, (sockaddr*)ptr->ai_addr, 0))
{
    std::cerr << std::endl;
    std::cerr << __FILE__ <<" Line: " << __LINE__ ;
    std::cerr << " - QOSStartTrackingClient failed. Exception code: "; 
    std::cerr << GetLastError() ;
}
else
{
    std::cout << "QoS client tracking stopped." << std::endl;
}

要求

要求 值
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 [仅限桌面应用]
目标平台 Windows
标头 qos2.h (包括 Qos2.h)
Library Qwave.lib
DLL Qwave.dll

另请参阅

QOSStartTrackingClient

质量 Windows 音频/视频体验 (qWAVE)