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) |