NDIS_WWAN_PACKET_SERVICE_STATE结构(ndiswwan.h)
NDIS_WWAN_PACKET_SERVICE_STATE结构表示 MB 设备的数据包服务附件状态。
语法
typedef struct _NDIS_WWAN_PACKET_SERVICE_STATE {
NDIS_OBJECT_HEADER Header;
WWAN_STATUS uStatus;
WWAN_PACKET_SERVICE PacketService;
} NDIS_WWAN_PACKET_SERVICE_STATE, *PNDIS_WWAN_PACKET_SERVICE_STATE;
成员
Header
包含有关NDIS_WWAN_PACKET_SERVICE_STATE结构的类型、修订和大小信息的标头。 MB 服务使用下表中显示的值设置标头,该标头将数据结构发送到微型端口驱动程序,以便 集作。 微型端口驱动程序在将数据结构发送到 MB 服务时,必须设置具有相同值的标头。
标头子member | 价值 |
---|---|
类型 | NDIS_OBJECT_TYPE_DEFAULT |
校订 | 支持 5G 的 Windows 10 版本 1903 微型端口驱动程序将此设置为NDIS_WWAN_PACKET_SERVICE_STATE_REVISION_2。 不支持 5G 或适用于早期版本的 Windows 的微型端口驱动程序将此设置设置为NDIS_WWAN_PACKET_SERVICE_STATE_REVISION_1。 |
大小 | sizeof(NDIS_WWAN_PACKET_SERVICE_STATE) |
有关这些成员的详细信息,请参阅 NDIS_OBJECT_HEADER。
uStatus
对于未经请求的事件(NDIS_STATUS_INDICATION::RequestId = 0),微型端口驱动程序必须将此设置为WWAN_STATUS_SUCCESS。
WWAN_STATUS_SUCCESS还设置为成功执行 集 和 查询 请求。
如果请求的状态和当前状态与 集 请求相同,则微型端口驱动程序应返回WWAN_STATUS_SUCCESS。
下表显示了其他可能的错误状态代码。
价值 | 意义 |
---|---|
WWAN_STATUS_PIN_REQUIRED | 设备需要 PIN 值输入。 |
WWAN_STATUS_FAILURE | 无法获取或设置数据包服务状态。 |
WWAN_STATUS_NOT_INITIALIZED | 作失败,因为设备正在初始化。 在设备就绪状态更改为 WwanReadyStateInitialized后重试作。 |
WWAN_STATUS_SIM_NOT_INSERTED | 作失败,因为 SIM 卡未完全插入设备。 |
WWAN_STATUS_BAD_SIM | 作失败,因为检测到错误的 SIM 卡。 |
如果数据包附加 设置 请求失败,微型端口驱动程序可以返回下表中显示的错误代码(除了上面列出的代码)。
价值 | 意义 |
---|---|
WWAN_STATUS_FAILURE | 数据包附加或数据包分离失败。 详细信息在 uNwError WWAN_PACKET_SERVICE 结构的成员处设置。 对于其他WWAN_STATUS_XXX错误,应将 uNwError 设置为零。 |
WWAN_STATUS_SERVICE_NOT_ACTIVATED | 由于服务激活失败或订阅过期,设备不允许设置数据包服务状态。 |
WWAN_STATUS_PROVIDER_NOT_VISIBLE | 数据包服务作的提供程序不可见。 |
WWAN_STATUS_NOT_REGISTERED | 设备未处于注册状态,无法执行数据包附加作。 |
WWAN_STATUS_NO_DEVICE_SUPPORT | 此基于 CDMA 的设备不支持 SET 数据包服务。 |
WWAN_STATUS_RADIO_POWER_OFF | 无法进行数据包附加,因为无线电已关闭。 |
WWAN_STATUS_SIM_NOT_INSERTED | 未插入 SIM 卡。 |
WWAN_STATUS_BAD_SIM | 检测到错误的 SIM 卡。 |
PacketService
表示 MB 设备的数据包服务附件状态的格式化 WWAN_PACKET_SERVICE 对象。
要求
要求 | 价值 |
---|---|
最低支持的客户端 | 在 Windows 7 及更高版本的 Windows 中可用。 |
标头 | ndiswwan.h (包括 Ndiswwan.h) |