共用方式為


NDIS_STATUS_WWAN_PIN_INFO

迷你埠驅動程式會使用NDIS_STATUS_WWAN_PIN_INFO通知來回應 OID 查詢,並設定 OID_WWAN_PIN的要求。

迷你埠驅動程式無法使用此通知來傳送未經請求的事件。

此通知會使用 NDIS_WWAN_PIN_INFO 結構。

言論

迷你埠驅動程式應傳回 MB 裝置目前預期回應查詢要求的個人識別號碼 (PIN) 相關信息。 迷你埠驅動程式應傳回填入的狀態通知,如下列各節所述,以回應設定要求。

回應 WwanPinOperationEnter 要求

當迷你埠驅動程式使用NDIS_STATUS_WWAN_PIN_INFO通知來回應 WwanPinOperationEnter 要求時,它們應該實作下列程式:

  • 若要成功 WwanPinOperationEnter 查詢要求,當 MB 裝置不再需要 PIN 時,迷你埠驅動程式必須將 uStatus 設定為 WWAN_STATUS_SUCCESS,PinTypeWwanPinTypeNone

  • 針對 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 設定為與 NDIS_WWAN_SET_PIN PinType 相同的值。

    • PIN 封鎖:AttemptsRemaining 為零時,會封鎖 PIN。 如果 PIN 解除封鎖作業無法使用,迷你埠驅動程式必須將 uStatus 設定為 WWAN_STATUS_FAILURE,並將 PinType 設定為 WwanPinTypeNone。 所有其他成員都會被忽略。

      注意 如果 MB 裝置支援 PIN 解除封鎖作業,迷你埠驅動程式應遵循 PIN 解除封鎖步驟來回應要求。

    • PIN 解除封鎖:當 AttemptsRemaining 為零時,就會封鎖 PIN。 若要解除封鎖 PIN,MB 裝置可能會要求對應的 PIN 解除鎖定密鑰(PUK),如果適用的話。 在此情況下,迷你埠驅動程序必須將 PinType 設定為對應的 WwanPinTypeXxxPUK 的相關詳細數據。

    • 封鎖的PUK:如果失敗的試用版數目超過輸入WwanPinTypeXxxPUK 的預設值,則會封鎖PUK。 迷你埠驅動程序必須將 uStatus 設定為 WWAN_STATUS_FAILURE,並將 PinType 設定為 WwanPinTypeNone來發出訊號。 如果 PUK1 遭到封鎖,迷你埠驅動程式必須將 ReadyState 設定為 WwanReadyStateBadSim傳送NDIS_STATUS_WWAN_READY_INFO。

回應 WwanPinOperationEnable、WwanPinOperationDisable 或 WwanPinOperationChange 要求

當迷你埠驅動程式使用NDIS_STATUS_WWAN_PIN_INFO通知來回應 WwanPinOperationEnableWwanPinOperationDisableWwanPinOperationChange時,應該實作下列作業:

  • 若要成功要求,迷你埠驅動程序必須將 uStatus 設定為 WWAN_STATUS_SUCCESS。 如需WWAN_PIN_INFO中的其他成員,請參閱下列情況。

  • 當 PIN 已處於要求狀態時,迷你埠驅動程式必須將 uStatus 設定為啟用 PIN 和停用 PIN 的作業WWAN_STATUS_SUCCESS。 Miniport 驅動程式必須將 PinType 設定為 WwanPinTypeNone。 系統會忽略其他成員。

  • 當 PIN 模式從停用變更為啟用時,PIN 狀態應該是 WwanPinStateNone。

  • 如果啟用 PIN1,當電源迴圈到 MB 裝置時,PIN 狀態應會變成 WwanPinStateEnter。

  • 針對所有其他 PIN,PIN 狀態可能會根據 MB 裝置特定條件,從 WwanPinStateNone 變更為 WwanPinStateEnter。

  • 不支援 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。 在此情況下, miniport 驅動程式必須將 uStatus 設定為 WWAN_STATUS_FAILURE,PinType 為對應的 WwanPinTypeXxxPUK、PinStateWwanPinStateEnterAttemptsRemaining 應該有允許輸入有效 PUK 的嘗試次數。

    如果 PIN 封鎖會導致 MB 裝置或 SIM 卡遭到封鎖,迷你埠驅動程式必須傳送事件通知,並將 ReadyState 設為 WwanReadyStateDeviceLocked

  • 如果 PIN1 封鎖時有作用中的 PDP 內容,迷你埠驅動程式必須停用 PDP 內容,並將有關 PDP 停用和鏈接狀態變更的通知傳送至作系統。

要求

版本

適用於 Windows 7 和更新版本的 Windows。

頁眉

Ndis.h

另請參閱

OID_WWAN_PIN

NDIS_STATUS_WWAN_PIN_INFO