MsQuic 开源项目教程

MsQuic 开源项目教程

1. 项目目录结构及介绍

MsQuic 的目录结构设计清晰，主要分为以下几个部分：

• include: 包含了 MsQuic 的头文件，供外部项目进行编译链接时引用。
• src: 源代码目录，包含了 MsQuic 的核心实现，包括协议处理、平台相关的适配代码等。
• tools: 提供了一些辅助工具，如构建脚本和测试用例。
• samples: 示例应用程序，帮助开发者了解如何在实际项目中使用 MsQuic。
• build: 构建系统相关的内容，如 CMake 配置文件。

2. 项目的启动文件介绍

由于 MsQuic 是一个库，它不提供单独的启动文件。通常，你会在 samples 目录下找到示例应用来了解如何初始化 MsQuic 连接。例如，samples/basic_client 和 samples/basic_server 分别展示了客户端和服务端的基本用法。

• basic_client.c: 客户端示例，展示了如何创建 MsQuic 连接到服务器并发送接收数据。
• basic_server.c: 服务端示例，演示如何监听连接请求并处理来自客户端的数据。

在这些示例中，初始化 MsQuic 通常涉及调用 QuicApiInit 函数，并使用 QuicConnStart 来启动一个新的 QUIC 连接。

3. 项目的配置文件介绍

MsQuic 使用 CMake 作为构建系统，所以没有传统的配置文件。但有一些关键的设置可以通过 CMake 变量控制：

• MSQUIC_BUILD_SAMPLES: 默认开启，用于决定是否构建样本应用。设为 OFF 可以跳过构建。
• MSQUIC_USE_SYSTEM_TLS: 若设为 ON，则使用系统内置的 TLS 库；设为 OFF 则使用 MsQuic 自带的 TLS 实现。
• MSQUIC_X64: 设为 ON 或 OFF 根据目标平台选择构建 x64 或者 x86 版本。

为了定制配置，可以在执行 cmake 命令时传递这些变量，例如：

cmake -S . -B build -DMSQUIC_BUILD_SAMPLES=OFF -DMSQUIC_USE_SYSTEM_TLS=ON

这将在 build 目录下构建 MsQuic 并关闭样例应用的构建，同时启用系统提供的 TLS 支持。

请注意，以上信息基于开源项目 MsQuic 在 GitHub 上的最新情况，实际目录结构和配置可能会随着项目更新而变化。在使用前，请务必参考最新的官方文档或源码仓库。