NDIS_WWAN_PREFERRED_PROVIDERS 结构 (ndiswwan.h)

NDIS_WWAN_PREFERRED_PROVIDERS 结构表示首选提供程序的列表,包括列表中的提供程序数。

语法

typedef struct _NDIS_WWAN_PREFERRED_PROVIDERS {
  NDIS_OBJECT_HEADER Header;
  WWAN_STATUS        uStatus;
  WWAN_LIST_HEADER   PreferredListHeader;
} NDIS_WWAN_PREFERRED_PROVIDERS, *PNDIS_WWAN_PREFERRED_PROVIDERS;

成员

Header

具有有关NDIS_WWAN_PREFERRED_PROVIDERS结构的类型、修订和大小信息的标头。 MB 服务在将数据结构发送到微型端口驱动程序进行 设置 操作时,使用下表中显示的值设置 标头。 微型端口驱动程序在将数据结构发送到 MB 服务时,必须使用相同的值设置 标头。

标头子成员
类型 NDIS_OBJECT_TYPE_DEFAULT
修订 NDIS_WWAN_PREFERRED_PROVIDERS_REVISION_1
大小 sizeof (NDIS_WWAN_PREFERRED_PROVIDERS)
 

有关这些成员的详细信息,请参阅 NDIS_OBJECT_HEADER

uStatus

微型端口驱动程序必须将此设置为WWAN_STATUS_SUCCESS未经请求的事件 (NDIS_STATUS_INDICATION::RequestId = 0) 。 WWAN_STATUS_SUCCESS也是为成功执行NDIS_WWAN_SET_PREFERRED_PROVIDERS而设置的。

下表显示了其他可能的错误状态代码, (其他成员不需要通过微型端口驱动程序) 进行更新。

含义
WWAN_STATUS_PIN_REQUIRED 设备需要输入 PIN 值。
WWAN_STATUS_READ_FAILURE 从设备或 SIM 卡卡或两者读取信息失败。 例如,SIM 卡没有预配首选提供商信息。
WWAN_STATUS_BAD_SIM 检测到错误的 SIM 卡。
WWAN_STATUS_SIM_NOT_INSERTED 未插入设备中的 SIM 卡。
WWAN_STATUS_NO_DEVICE_SUPPORT 不支持 设置 请求。

PreferredListHeader

一个格式化 WWAN_LIST_HEADER 对象,该对象表示首选提供程序的列表,包括列表中的提供程序数。

它们指向使用 WWAN_LIST_HEADER 结构WWAN_PROVIDER2 列表。 WwanDataClass 标志描述特定数据访问技术的首选项,并且可以设置为其自己的手机网络类中的任意组合。

设置OID_WWAN_PREFERRED_PROVIDERS请求的响应必须在 PreferenceListHeader 中包含零个元素。

要求

要求
最低受支持的客户端 在 Windows 7 和更高版本的 Windows 中可用。
标头 ndiswwan.h (包括 Ndiswwan.h)

另请参阅

NDIS_OBJECT_HEADER

WWAN_LIST_HEADER