структура NDIS_WWAN_PACKET_SERVICE_STATE (ndiswwan.h)
Структура NDIS_WWAN_PACKET_SERVICE_STATE представляет состояние вложения службы пакетов устройства в МБ.
Синтаксис
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 |
| Редакция | Windows 10 версии 1903 для драйверов miniport, поддерживающих 5G, для этого параметра задано значение NDIS_WWAN_PACKET_SERVICE_STATE_REVISION_2. Драйверы miniport, которые не поддерживают 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 , представляющий состояние вложения службы пакетов устройства в МБ.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Доступно в Windows 7 и более поздних версиях Windows. |
| Верхняя часть | ndiswwan.h (включая Ndiswwan.h) |