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)

另请参阅

NDIS_OBJECT_HEADER

WWAN_PACKET_SERVICE