一. 前言

WebRTC 音视频通话的双方需要交换候选者信息，然后进行连通性检测，因此对于通信的每一方都需要收集自己的主机地址，映射地址等，通过收集网卡信息我们可以知道网卡配置的地址信息。

二. 收集网卡信息

1. 收集网卡信息的时机

WebRTC 收集网卡信息的时机是在调用 PeerConnection::SetLocalDescription，该函数会调用 JsepTransportController::MaybeStartGathering 收集候选者。

JsepTransportController::MaybeStartGathering 会调用 P2PTransportChannel::MaybeStartGathering，该函数再调用 PortAllocator::CreateSession 创建 BasicPortAllocatorSession。

BasicPortAllocatorSession 构造函数中调用 BasicNetworkManager::StartUpdating，它给网络线程发送 KUpdateNetworksMessage 消息。

接收到 KUpdateNetworksMessage 后调用 BasicNetworkManager::UpdateNetworksContinually，然后再调用 BasicNetworkManager::UpdateNetworksOnce，最终调用 CreateNetworks 开始收集网卡信息。

2. CreateNetworks

Windows 使用 GetAdaptersAddresses 获取网卡关联的地址信息，关于该 API 的详细介绍请见这里，如下仅介绍 WebRTC 中使用到的关键参数信息。

IPHLPAPI_DLL_LINKAGE ULONG GetAdaptersAddresses(
  [in]      ULONG                 Family,
  [in]      ULONG                 Flags,
  [in]      PVOID                 Reserved,
  [in, out] PIP_ADAPTER_ADDRESSES AdapterAddresses,
  [in, out] PULONG                SizePointer
);

Family 的取值和含义如下。

值	含义
AF_UNSPEC	返回IPv4和IPv6类型的地址信息
AF_INET	仅返回IPv4类型的地址信息
AF_INET6	仅返回IPv6类型的地址信息

Flags 的部分取值和对应的含义如下（仅介绍 WebRTC 中使用到的 Flag）。

值	含义
GAA_FLAG_SKIP_DNS_SERVER	不返回DNS地址
GAA_FLAG_SKIP_ANYCAST	不返回IPv6任意地址
GAA_FLAG_SKIP_MULTICAST	不返回多播地址
GAA_FLAG_INCLUDE_PREFIX	返回适配器上IP地址前缀列表

Reserved：保留参数，设置为 0 即可。

AdapterAddress：地址输出参数，它是 IP_ADAPTER_ADDRESSES 数据的指针，通过该数据结构内的 Next 指针即可遍历所有的 IP_ADAPTER_ADDRESSES 信息，对于 Windows 版本大于等于 VISTA 的系统而言，IP_ADAPTER_ADDRESSES 是 IP_ADAPTER_ADDRESSES_LH，否则 IP_ADAPTER_ADDRESSES 是 IP_ADAPTER_ADDRESSES_XP，下面会以 IP_ADAPTER_ADDRESSES_LH 举例说明数据结构内重要信息的含义。

SizePointer：输出参数，表示 AdapterAddress 指向的缓冲区大小。

WebRTC 调用 GetAdaptersAddresses 获取网卡信息的代码如下所示。