Windows 平台应用程序 QoS 高级策略配置

原创已于 2025-10-16 19:59:40 修改 · 691 阅读

27 ·

CC 4.0 BY-SA版权

文章标签：

#windows #开发语言 #c++ #qos #qos2 #DSCP #网络

于 2025-10-16 19:59:01 首次发布

C/C++ 同时被 3 个专栏收录

436 篇文章

订阅专栏

Markdown

191 篇文章

订阅专栏

143 篇文章

订阅专栏

🌟 Windows 平台应用程序 QoS 高级策略配置

引用：

📚 前言与背景知识

在Windows平台中，服务质量(QoS) 策略对于网络应用的性能优化至关重要。本文将探讨两种配置QoS策略的方法，并提供完整的C++实现方案。

🔗 前情提要文献

🛠️ QoS策略配置方法对比

📋 方法对比表

方法类型	适用场景	配置复杂度	灵活性	持久性
程序设置	开发者可控的应用	高	高	应用级别
组策略控制	系统级别统一管理	低	中	系统级别

📊 QoS配置方法决策流程图

⚙️ Windows QoS策略演进历史

🕰️ 版本兼容性时间线

在这里插入图片描述

🔒 安全策略演进

Windows Vista之前: 开放标准Socket API设置QoS
Vista/7/2008: 部分限制，通过注册表可解禁
Windows 8.1/2012 RC2+: 完全禁用，必须使用QoS2接口

🎯 方法一：组策略配置详解

🚀 配置步骤详解

步骤1-2: 启动组策略编辑器

# 以管理员身份运行CMD，执行以下命令
gpedit.msc

步骤3-7: 导航到QoS策略设置

展开控制台树: Windows设置 → 基于策略的QoS
配置高级QoS策略:

高级QoS策略配置

QoS策略详细设置

步骤8-12: 创建新QoS策略

策略基本信息配置:
新建QoS策略

应用程序路径指定:
指定应用程序路径

协议类型选择:
协议选择配置

💻 方法二：程序代码实现

🏗️ QoS类设计架构

📝 完整C++实现代码

/**
 * @file QoSS.cpp
 * @brief Windows平台QoS服务质量控制实现
 * @details 通过QoS2 API为Socket连接设置DSCP值，优化网络传输质量
 */

#include <ppp/stdafx.h>
#include <ppp/net/IPEndPoint.h>
#include <windows/ppp/net/QoSS.h>

#include <Windows.h>
#include <qos2.h>  // Windows QoS2 API头文件

using ppp::net::IPEndPoint;

namespace ppp
{
    namespace net
    {
        /**
         * @brief QoSS类构造函数
         * @param fd Socket文件描述符
         * @note 初始化QoS相关句柄为NULL
         */
        QoSS::QoSS(int fd) noexcept
            : fd_(fd)     // 存储Socket文件描述符
            , h_(NULL)    // QoS句柄初始化为NULL
            , f_(NULL)    // 流标识符初始化为NULL
        {
            // 构造函数体为空，初始化列表完成所有工作
        }

        /**
         * @brief QoSS类析构函数
         * @note 自动清理QoS资源，防止内存泄漏
         */
        QoSS::~QoSS() noexcept
        {
            // 检查QoS句柄是否有效
            if (NULL != h_)
            {
                // 如果流标识符有效，从流中移除Socket
                if (f_ != 0)
                {
                    QOSRemoveSocketFromFlow(h_, fd_, f_, 0);
                }

                // 关闭QoS句柄，释放系统资源
                QOSCloseHandle(h_);
            }
        }

        /**
         * @brief 创建QoS策略实例
         * @param fd Socket文件描述符
         * @param host 目标主机地址
         * @param port 目标端口号
         * @param noaddress 是否不指定具体地址
         * @return std::shared_ptr<QoSS> QoS策略智能指针
         * 
         * @details 此函数完成以下工作：
         * 1. 创建QoS句柄
         * 2. 将Socket添加到QoS流
         * 3. 设置DSCP值(26对应Flash报文优先级)
         */
        std::shared_ptr<QoSS> QoSS::New(int fd, 
                                       const boost::asio::ip::address& host, 
                                       int port, 
                                       bool noaddress) noexcept
        {
            // 验证Socket文件描述符有效性
            if (fd == INVALID_SOCKET)
            {
                return NULL;  // 无效Socket，返回空指针
            }

            // 创建QoSS对象实例
            std::shared_ptr<QoSS> qos = make_shared_object<QoSS>(fd);
            if (NULL == qos)
            {
                return NULL;  // 内存分配失败
            }

            // 定义QoS版本信息结构体
            QOS_VERSION ver = { 1, 0 };
            
            // 创建QoS句柄，失败则返回NULL
            if (!QOSCreateHandle(&ver, &qos->h_))
            {
                return NULL;
            }

            // 根据noaddress参数选择不同的流创建方式
            if (noaddress)
            {
                // 不指定具体地址的流创建
                if (!QOSAddSocketToFlow(qos->h_, 
                                       fd, 
                                       NULL, 
                                       QOSTrafficTypeControl, 
                                       QOS_NON_ADAPTIVE_FLOW, 
                                       &qos->f_))
                {
                    return NULL;  // 流创建失败
                }
            }
            else
            {
                // 验证端口号范围有效性
                if (port <= IPEndPoint::MinPort || port > IPEndPoint::MaxPort)
                {
                    return NULL;  // 端口号无效
                }

                // 验证IP地址类型和有效性
                if (!host.is_v4() && !host.is_v6())
                {
                    return NULL;  // 不是IPv4或IPv6地址
                }

                if (IPEndPoint::IsInvalid(host))
                {
                    return NULL;  // 无效的IP地址
                }

                // 根据IP地址类型分别处理
                if (host.is_v4())
                {
                    // IPv4地址处理
                    sockaddr_in in{};
                    in.sin_family = AF_INET;                    // 地址族: IPv4
                    in.sin_port = htons(port);                  // 端口号(网络字节序)
                    in.sin_addr.s_addr = htonl(host.to_v4().to_uint());  // IP地址转换

                    // 创建IPv4 QoS流
                    if (!QOSAddSocketToFlow(qos->h_, 
                                           fd, 
                                           reinterpret_cast<sockaddr*>(&in), 
                                           QOSTrafficTypeControl, 
                                           QOS_NON_ADAPTIVE_FLOW, 
                                           &qos->f_))
                    {
                        return NULL;
                    }
                }
                else
                {
                    // IPv6地址处理
                    sockaddr_in6 in6{};
                    in6.sin6_family = AF_INET6;                // 地址族: IPv6
                    in6.sin6_port = htons(port);               // 端口号(网络字节序)
                    memcpy(&in6.sin6_addr, 
                           host.to_v6().to_bytes().data(), 
                           sizeof(in6.sin6_addr));             // IPv6地址拷贝

                    // 创建IPv6 QoS流
                    if (!QOSAddSocketToFlow(qos->h_, 
                                           fd, 
                                           reinterpret_cast<sockaddr*>(&in6), 
                                           QOSTrafficTypeControl, 
                                           QOS_NON_ADAPTIVE_FLOW, 
                                           &qos->f_))
                    {
                        return NULL;
                    }
                }
            }

            // 设置DSCP值: 26对应Flash Override优先级
            // DSCP值范围: 0-63，需要管理员权限才能设置成功
            DWORD dscp = 26;

            // 配置QoS流的DSCP参数
            // 注意: 此操作需要管理员权限，普通用户会失败但不会影响程序运行
            if (!QOSSetFlow(qos->h_, 
                           qos->f_, 
                           QOSSetOutgoingDSCPValue, 
                           sizeof(DWORD), 
                           &dscp, 
                           0, 
                           NULL))
            {
                // DSCP设置失败，但仍返回QoS对象(基础流功能仍可用)
                return qos;
            }

            return qos;  // 返回配置完成的QoS对象
        }
    }
}