OID_WWAN_READY_INFO
OID_WWAN_READY_INFO返回设备就绪状态,其中包括其订阅者标识模块 (SIM 卡) 。 这通常发生在任何会话开始时。
不支持设置请求。
如果设备支持双 SIM 卡插槽,主机可以从设备中的活动 SIM 槽或非活动 SIM 卡槽查询就绪状态。 此 OID 的有效负载包含 NDIS_WWAN_QUERY_READY_INFO 结构,而该结构又包含指定 UICC 槽 ID 的 WWAN_QUERY_READY_INFO 结构。
微型端口驱动程序必须异步处理查询请求,最初将NDIS_STATUS_INDICATION_REQUIRED返回到原始请求,然后发送包含NDIS_WWAN_READY_INFO结构的NDIS_STATUS_WWAN_READY_INFO状态通知,该结构指示在完成查询请求时 MB 设备的就绪状态。
注解
有关使用此 OID 的详细信息,请参阅 MB 设备就绪情况。
微型端口驱动程序可以在处理查询操作时访问设备内存或 SIM 卡,但不应访问提供程序网络。
微型端口驱动程序应等到 (清除 PIN(如果需要) ),然后读取订阅者的标识和电话号码 () ) (TN,然后将 NDIS_WWAN_READY_INFO 结构的 ReadyInfo.ReadyState 成员设置为 WwanReadyStateInitialized。
微型端口驱动程序不得OID_WWAN_READY_INFO失败,并且必须始终返回正确的设备就绪状态。
每当设备就绪状态发生更改时,微型端口驱动程序必须始终通知 MB 服务。
微型端口驱动程序应遵循以下步骤来提供良好的用户体验:
如果 PIN1 已锁定,微型端口驱动程序必须首先发送就绪状态事件通知,并将 ReadyInfo.ReadyState 设置为 WwanReadyStateDeviceLocked。 然后,MB 服务向微型端口驱动程序发送OID_WWAN_PIN的 OID 集请求。 设备解锁后,微型端口驱动程序必须发送另一个就绪状态事件通知, 并将 ReadyInfo.ReadyState 设置为 WwanReadyStateInitialized。 在成功解锁 PIN1 之前,微型端口驱动程序不得将设备就绪状态更改为 WwanReadyStateInitialized。
如果不存在 SIM 卡卡,则 MB 服务加载微型端口驱动程序时,微型端口驱动程序必须先发送事件通知,并将 ReadyInfo.ReadyState 设置为 WwanReadyStateSimNotInserted,就像允许插入或删除 SIM 卡的设备一样。 如果设备能够检测 SIM 卡卡的热插入,则微型端口驱动程序必须在用户插入 SIM 卡时发送另一个事件通知,并将 ReadyInfo.ReadyState 设置为 WwanReadyStateInitialized。
能够检测服务激活状态的设备必须将 ReadyInfo.ReadyState 设置为 WwanReadyStateNotActivated。 此外,如果微型端口驱动程序支持服务激活,微型端口驱动程序将收到OID_WWAN_SERVICE_ACTIVATION的 OID 集请求。 成功完成服务激活后,微型端口驱动程序必须发送另一个事件通知, 并将 ReadyInfo.ReadyState 设置为 WwanReadyStateInitialized。
需要特定固件修订版的微型端口驱动程序必须确保提供正确的固件版本。 如果固件版本不可用,微型端口驱动程序应通过将 ReadyInfo.ReadyState 设置为 WwanReadyStateFailure 来完成事件通知事务。
要求
版本:在 Windows 7 及更高版本的 Windows 中可用。
标头:Ntddndis.h (包括 Ndis.h)