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 服务时，必须使用相同的值设置 标头。

标头子成员 值
类型 NDIS_OBJECT_TYPE_DEFAULT
修订 Windows 10，支持 5G 的版本 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

微型端口驱动程序必须将此设置为WWAN_STATUS_SUCCESS未经请求的事件 (NDIS_STATUS_INDICATION：：RequestId = 0) 。

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 数据包附加或数据包分离失败。 有关详细信息，请参阅 WWAN_PACKET_SERVICE 结构的 uNwError 成员。 对于其他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

一个格式化 WWAN_PACKET_SERVICE 对象，表示 MB 设备的数据包服务附件状态。

要求

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

另请参阅

NDIS_OBJECT_HEADER

WWAN_PACKET_SERVICE