共用方式為


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 值仍然是非零。 Miniport 驅動程式必須將 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 遭到封鎖,迷你埠驅動程式必須傳送設定為WwanReadyStateBadSim的 NDIS_STATUS_WWAN_READY_INFO。

回應 WwanPinOperationEnable、WwanPinOperationDisable 或 WwanPinOperationChange 要求

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

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

  • 當 PIN 已處於要求狀態時,迷你埠驅動程式必須將 uStatus 設定為WWAN_STATUS_SUCCESS啟用 PIN 和 PIN 停用作業。 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。 在此情況下,迷你埠驅動程式必須將 uStatus 設定為 WWAN_STATUS_FAILURE、 將 PinType 設定為對應的 WwanPinTypeXxxPUK、 PinState 設為 WwanPinStateEnter,而 AttemptsRemaining 應允許輸入有效的 PUK 嘗試次數。

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

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

規格需求

版本

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

標頭

Ndis.h

另請參閱

OID_WWAN_PIN

NDIS_STATUS_WWAN_PIN_INFO