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 通知响应 WwanPinOperationEnable、 WwanPinOperationDisable 和 WwanPinOperationChange 时，它们应实现以下操作：
对于成功的请求，微型端口驱动程序必须将 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 设置为 WwanPinTypeNone。 AttemptsRemaining 应设置为 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 |