структура 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. Служба МБ задает заголовок со значениями, отображаемыми в следующей таблице при отправке структуры данных в драйвер минипорта для задания операций. Драйверы минипорта должны задать заголовок с одинаковыми значениями при отправке структуры данных в службу МБ.
| Вложенный элемент заголовка | Ценность |
|---|---|
| Тип | NDIS_OBJECT_TYPE_DEFAULT |
| Пересмотр | Драйверы мини-порта Windows 10 версии 1903, поддерживающие 5G, задайте для этого значение 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 | Для устройства требуется ввод ПИН-кода. |
| 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 | Служба пакетов SET не поддерживается этим устройством на основе CDMA. |
| 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) |