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通知來回應 WwanPinOperationEnable、 WwanPinOperationDisable和 WwanPinOperationChange時,應該實作下列作業:
對於成功的要求,迷你埠驅動程式必須將 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 設定為 WwanPinTypeNone。 AttemptsRemaining 應該設定為 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 |