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 服务时,必须设置具有相同值的标头。

标头子member 价值
类型 NDIS_OBJECT_TYPE_DEFAULT
校订 NDIS_WWAN_PREFERRED_PROVIDERS_REVISION_1
大小 sizeof(NDIS_WWAN_PREFERRED_PROVIDERS)
 

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

uStatus

微型端口驱动程序必须为未经请求的事件(NDIS_STATUS_INDICATION::RequestId = 0)WWAN_STATUS_SUCCESS。 此外,还会设置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