NDIS_STATUS_WWAN_PIN_INFO

微型端口驱动程序使用 NDIS_STATUS_WWAN_PIN_INFO 通知来响应 OID 查询并设置OID_WWAN_PIN。

微型端口驱动程序无法使用此通知发送未经请求的事件。

通知使用 NDIS_WWAN_PIN_INFO 结构。

注解

微型端口驱动程序应返回有关个人标识号 (PIN) MB 设备当前预期响应查询请求的信息。 微型端口驱动程序应返回填充的状态通知,如以下部分所述,以响应设置请求。

响应 WwanPinOperationEnter 请求

当微型端口驱动程序使用 NDIS_STATUS_WWAN_PIN_INFO 通知响应 WwanPinOperationEnter 请求时,应实现以下过程:

  • 对于成功的 WwanPinOperationEnter 查询请求,当 MB 设备不再需要 PIN 时,微型端口驱动程序必须将 uStatus 设置为 WWAN_STATUS_SUCCESS,将 PinType 设置为 WwanPinTypeNone

  • 对于失败的 WwanPinOperationEnter 请求,微型端口驱动程序必须将 uStatus 设置为 WWAN_STATUS_FAILURE并包含根据以下详细信息适用的数据:

    • PIN 已禁用或 PIN 不可预期:对于 WwanPinOperationEnter 设置请求,当 MB 设备禁用或当前不需要相应的 PIN 时,微型端口驱动程序必须将 PinType 设置为 WwanPinTypeNone。 将忽略所有其他成员。

    • 不支持 PIN:如果 MB 设备不支持给定的 PIN,微型端口驱动程序必须将 uStatus 设置为 WWAN_STATUS_NO_DEVICE_SUPPORT。

    • PIN 重新尝试:在此模式下,MB 设备要求重新输入 PIN,因为此特定类型的 PIN 的 AttemptsRemaining 值仍为非零。 微型端口驱动程序必须将 PinType 设置为 与中 PinType 相同的值NDIS_WWAN_SET_PIN。

    • PIN 阻止:当 AttemptsRemaining 为零时,将阻止 PIN。 如果 PIN 取消阻止操作不可用,微型端口驱动程序必须将 uStatus 设置为 WWAN_STATUS_FAILURE PinType 设置为 WwanPinTypeNone。 将忽略所有其他成员。

      注意 如果 MB 设备支持 PIN 取消阻止操作,微型端口驱动程序应遵循 PIN 取消阻止步骤来响应请求。

    • PIN 取消阻止:当 AttemptsRemaining 为零时,将阻止 PIN。 若要取消阻止 PIN,MB 设备可能会请求 PUK (PIN 解锁) (如果适用)。 在这种情况下,微型端口驱动程序必须使用相关详细信息将 PinType 设置为相应的 WwanPinTypeXxxPUK。

    • 阻止的 PUK:如果失败的试用次数超过输入 WwanPinTypeXxxPUK 的预设值,则 PUK 将被阻止。 微型端口驱动程序必须通过将 uStatus 设置为 WWAN_STATUS_FAILURE 将 PinType 设置为 WwanPinTypeNone 来发出信号。 如果 PUK1 被阻止,微型端口驱动程序必须发送一个NDIS_STATUS_WWAN_READY_INFO ReadyState 设置为 WwanReadyStateBadSim 的端口

响应 WwanPinOperationEnable、WwanPinOperationDisable 或 WwanPinOperationChange 请求

当微型端口驱动程序使用 NDIS_STATUS_WWAN_PIN_INFO 通知响应 WwanPinOperationEnableWwanPinOperationDisableWwanPinOperationChange 时,它们应实现以下操作:

  • 对于成功的请求,微型端口驱动程序必须将 uStatus 设置为 WWAN_STATUS_SUCCESS。 有关其他WWAN_PIN_INFO,请参阅以下情况。

  • 当 PIN 已WWAN_STATUS_SUCCESS PIN 时,微型端口驱动程序必须将 uStatus 设置为 WWAN_STATUS_SUCCESS以用于 PIN 启用和 PIN 禁用操作。 微型端口驱动程序必须将 PinType 设置为WwanPinTypeNone。 将忽略其他成员。

  • 当 PIN 模式从禁用更改为启用时,PIN 状态应为 WwanPinStateNone。

  • 如果启用了 PIN1,则当电源循环到 MB 设备时,PIN 状态应变为 WwanPinStateEnter。

  • 对于所有其他 PIN,PIN 状态可以从 WwanPinStateNone 更改为 WwanPinStateEnter,具体取决于 MB 设备特定的条件。

  • 不支持 PIN:如果 MB 设备不支持 PIN 操作,微型端口驱动程序必须将 uStatus 设置为 WWAN_STATUS_NO_DEVICE_SUPPORT。 例如,MB 设备通常不支持启用和禁用 PIN2,因此必须返回上述错误代码。 将忽略所有其他成员。

  • 必须输入 PIN:如果 PIN 操作需要输入 PIN,微型端口驱动程序必须将 uStatus 设置为 WWAN_STATUS_PIN_REQUIRED PinType 设置为 WwanPinTypeXxx。 将忽略其他成员。

  • PIN 更改操作:如果 MB 设备仅在处于启用状态时限制 PIN 值更改,则必须返回更改处于禁用状态的请求WWAN_STATUS_PIN_DISABLED。

  • PIN 重新分析:发生故障时,微型端口驱动程序必须将 uStatus 设置为 WWAN_STATUS_FAILURE,将 PinType 设置为与 NDIS_WWAN_SET_PIN 中指定的值。 将忽略其他成员, AttemptsRemaining 除外。 输入不正确的 PIN 时,可能会发生这种情况。

  • PIN 阻止:当 AttemptsRemaining 数为零时,将阻止 PIN。 如果 PIN 取消阻止操作不可用,微型端口驱动程序必须将 uStatus 设置为 WWAN_STATUS_FAILURE PinType 设置为 WwanPinTypeNoneAttemptsRemaining 应设置为 0,并忽略所有其他成员。

    注意 如果 MB 设备支持 PIN 取消阻止操作,微型端口驱动程序应遵循 PIN 取消阻止步骤来响应请求。

  • 取消阻止 PIN:当 AttemptsRemaining 为零时,将阻止 PIN。 若要取消阻止 PIN,MB 设备可以请求相应的 PUK(如果适用)。 在这种情况下,微型端口驱动程序必须将 uStatus 设置为 WWAN_STATUS_FAILURE,将 PinType 设置为相应的 WwanPinTypeXxxPUK,将 PinState 设置为 WwanPinStateEnter并且 AttemptsRemaining 应具有允许输入有效 PUK 的尝试次数。

    如果 MB 设备或 SIM 中的 PIN 阻止结果被阻止,微型端口驱动程序必须发送将 ReadyState 设置为 WwanReadyStateDeviceLocked 的事件通知

  • 如果 PIN1 阻止时存在活动的 PDP 上下文,微型端口驱动程序必须停用 PDP 上下文,并将有关 PDP 停用和链接状态更改的通知发送到操作系统。

要求

版本

在 Windows 7 和更高版本的 Windows 中可用。

标头

Ndis.h

请参阅

OID_WWAN_PIN

NDIS_STATUS_WWAN_PIN_INFO