OID_WWAN_VISIBLE_PROVIDERS

  • 项目

OID_WWAN_VISIBLE_PROVIDERS返回当前在 MB 设备范围内可见的网络提供程序列表。

不支持设置请求。

微型端口驱动程序必须异步处理查询请求，最初将NDIS_STATUS_INDICATION_REQUIRED返回到原始请求，然后发送包含 NDIS_WWAN_VISIBLE_PROVIDERS 结构的 NDIS_STATUS_WWAN_VISIBLE_PROVIDERS 状态通知，以在完成查询请求时提供有关可见网络提供程序的信息。

查询 请求将NDIS_WWAN_GET_VISIBLE_PROVIDERS结构指定为输入。 当 WWAN_GET_VISIBLE_PROVIDERS 中的 Action 成员设置为WWAN_GET_VISIBLE_PROVIDERS_ALL微型端口应返回所有可见的提供程序。 当 WWAN_GET_VISIBLE_PROVIDERS 中的 Action 成员设置为WWAN_GET_VISIBLE_PROVIDERS_MULTICARRIER微型端口应仅返回可设置为主提供商的可见多运营商提供程序。

设备返回的可见提供程序列表应为每个提供程序正确设置提供程序状态。 例如，多航道首选提供程序应标记为WWAN_PROVIDER_STATE_PREFERRED_MULTICARRIER，当前主提供程序（如果有）应标记为WWAN_PROVIDER_STATE_HOME，当前注册的提供程序（如果有）应标记为WWAN_PROVIDER_STATE_REGISTERED。

应设置 WWAN_PROVIDER2 结构的 Rssi 和 ErrorRate 成员（如果可用）。

注解

有关使用此 OID 的详细信息，请参阅 WWAN 提供程序操作。

微型端口驱动程序可以在处理查询操作时访问订阅服务器标识模块 (SIM 卡) ，但不应访问提供程序网络。

微型端口驱动程序应将 VisibleListHeader.ElementType 成员设置为 WwanStructProvider。

对于基于 CDMA 的网络，如果“首选漫游列表” (PRL) 中的任何网络当前可见，微型端口驱动程序应仅返回主提供程序。 对于基于 GSM 的网络，可见的提供程序列表中可能有多个提供程序。

在连接时不支持扫描可见提供程序的设备应在NDIS_WWAN_VISIBLE_PROVIDERS结构的 uStatus 成员中返回WWAN_STATUS_BUSY错误值。

在注册模式下，基于 GSM 和基于 CDMA 的设备都必须支持扫描可见提供程序。 但是，当数据包数据协议 (PDP) 上下文处于活动状态时，微型端口驱动程序不需要支持扫描可见提供程序， (例如，设备连接到提供程序的网络) 。

要求

版本

在 Windows 7 和更高版本的 Windows 中可用。

标头

 Ntddndis.h (包括 Ndis.h)

另请参阅

NDIS_WWAN_VISIBLE_PROVIDERS

NDIS_STATUS_WWAN_VISIBLE_PROVIDERS

WWAN 提供程序操作