NDIS_WWAN_PACKET_SERVICE_STATE結構(ndiswwan.h)
NDIS_WWAN_PACKET_SERVICE_STATE 結構代表 MB 裝置的封包服務附件狀態。
語法
typedef struct _NDIS_WWAN_PACKET_SERVICE_STATE {
NDIS_OBJECT_HEADER Header;
WWAN_STATUS uStatus;
WWAN_PACKET_SERVICE PacketService;
} NDIS_WWAN_PACKET_SERVICE_STATE, *PNDIS_WWAN_PACKET_SERVICE_STATE;
成員
Header
具有類型、修訂和大小資訊之NDIS_WWAN_PACKET_SERVICE_STATE結構的標頭。 MB 服務會使用下表中顯示的值來設定標頭,此標頭會將數據結構傳送至迷你埠驅動程式,以進行 集 作業。 迷你埠驅動程式在將數據結構傳送至 MB 服務時,必須使用相同的值來設定標頭。
標頭子成員 | 價值 |
---|---|
類型 | NDIS_OBJECT_TYPE_DEFAULT |
校訂 | 支援 5G 的 Windows 10 版本 1903 迷你埠驅動程式將此設定為 NDIS_WWAN_PACKET_SERVICE_STATE_REVISION_2。 不支援 5G 或舊版 Windows 的迷你埠驅動程式,請將此設定為 NDIS_WWAN_PACKET_SERVICE_STATE_REVISION_1。 |
大小 | sizeof(NDIS_WWAN_PACKET_SERVICE_STATE) |
如需這些成員的詳細資訊,請參閱 NDIS_OBJECT_HEADER。
uStatus
迷你埠驅動程序必須將此設定為WWAN_STATUS_SUCCESS未請求的事件(NDIS_STATUS_INDICATION::RequestId = 0)。
WWAN_STATUS_SUCCESS也會設定為成功執行 集 和 查詢 要求。
如果要求的狀態和目前狀態與 集 要求相同,則迷你埠驅動程序應該傳回WWAN_STATUS_SUCCESS。
下表顯示其他可能的錯誤狀態代碼。
價值 | 意義 |
---|---|
WWAN_STATUS_PIN_REQUIRED | 裝置需要 PIN 值輸入。 |
WWAN_STATUS_FAILURE | 無法取得或設定封包服務狀態。 |
WWAN_STATUS_NOT_INITIALIZED | 作業失敗,因為裝置正在進行初始化。 在裝置的就緒狀態變更為 WwanReadyStateInitialized之後,重試作業。 |
WWAN_STATUS_SIM_NOT_INSERTED | 作業失敗,因為 SIM 卡未完全插入裝置。 |
WWAN_STATUS_BAD_SIM | 作業失敗,因為偵測到錯誤的 SIM 卡。 |
迷你埠驅動程式可以傳回錯誤碼,如下表所示,因為封包附加 設定 要求失敗。
價值 | 意義 |
---|---|
WWAN_STATUS_FAILURE | 封包連結或封包卸離失敗。 詳細資訊設定於 uNwError WWAN_PACKET_SERVICE 結構的成員。 針對其他WWAN_STATUS_XXX錯誤,uNwError 應設定為零。 |
WWAN_STATUS_SERVICE_NOT_ACTIVATED | 裝置不允許因為服務啟用失敗或訂用帳戶過期而設定封包服務狀態。 |
WWAN_STATUS_PROVIDER_NOT_VISIBLE | 封包服務作業看不到提供者。 |
WWAN_STATUS_NOT_REGISTERED | 裝置未處於已註冊狀態,無法執行封包附加作業。 |
WWAN_STATUS_NO_DEVICE_SUPPORT | 此 CDMA 型裝置不支援 SET 封包服務。 |
WWAN_STATUS_RADIO_POWER_OFF | 無法封包附加,因為無線電已關閉。 |
WWAN_STATUS_SIM_NOT_INSERTED | 不會插入 SIM 卡。 |
WWAN_STATUS_BAD_SIM | 偵測到錯誤的 SIM 卡。 |
PacketService
格式化 WWAN_PACKET_SERVICE 物件,表示 MB 裝置的封包服務附件狀態。
要求
要求 | 價值 |
---|---|
最低支援的用戶端 | 適用於 Windows 7 和更新版本的 Windows。 |
標頭 | ndiswwan.h (包括 Ndiswwan.h) |