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