Поделиться через


структура WWAN_PACKET_SERVICE (wwan.h)

Структура WWAN_PACKET_SERVICE представляет состояние вложения службы пакетов устройства MB.

Синтаксис

typedef struct _WWAN_PACKET_SERVICE {
  ULONG                     uNwError;
  WWAN_PACKET_SERVICE_STATE PacketServiceState;
  ULONG                     AvailableDataClass;
  ULONG                     CurrentDataClass;
  WWAN_5G_FREQUENCY_RANGE   FrequencyRange;
  ULONG                     CurrentDataSubClass;
  WWAN_SINGLE_TAI           CurrentTai;
  ULONG                     Rel3GppVer;
} WWAN_PACKET_SERVICE, *PWWAN_PACKET_SERVICE;

Члены

uNwError

Ошибка конкретной сети в случае сбоя подключения пакета или отсоединения пакетов. Дополнительные сведения об этом члене см. в следующем разделе "Примечания".

PacketServiceState

Состояние службы пакетов устройства.

AvailableDataClass

Растровое изображение, представляющее, какие классы данных доступны устройству в текущей сети. Подробный список значений см. в разделе WwanDataClass члена WWAN_DEVICE_CAPS.

Драйверы мини-порта должны задать для этого элемента значение WWAN_DATA_CLASS_NONE, если устройство не зарегистрировано в сети, или если нет класса данных или если поддерживаемый класс данных недоступен. Драйверы мини-порта должны задать этот член с допустимым значением, если устройство зарегистрировано в сети.

CurrentDataClass

Одно значение из элемента WwanDataClass в WWAN_DEVICE_CAPS, представляющее, какой класс данных в настоящее время используется устройством.

Для всех служб данных, кроме HSPA, драйверы минипорта должны задать для этого элемента одно значение WWAN_DATA_CLASS_XXX. Для служб данных HSPA драйверы минипорта должны указывать битовую или WWAN_DATA_CLASS_HSDPA и WWAN_DATA_CLASS_HSUPA.

Минипорт-драйверы должны задать этот элемент с допустимым значением и отправить соответствующее уведомление, если службы устройства изменяют службы, например от 1xRTT до 1xEV-DO.

Драйверы минипорта должны задать для этого элемента значение WWAN_DATA_CLASS_CUSTOM если класс данных не является одним из предопределенных значений в WwanDataClass члена WWAN_DEVICE_CAPS.

FrequencyRange

Значение WWAN_5G_FREQUENCY_RANGE, указывающее диапазоны частот, которые использует устройство. Этот член действителен только в том случае, если CurrentDataClassWWAN_DATA_CLASS_5G_NSA или WWAN_DATA_CLASS_SA.

CurrentDataSubClass

Это поле используется только для NDIS_WWAN_PACKET_SERVICE_STATE_REVISION_3.

CurrentTai

Структура WWAN_SINGLE_TAI, представляющая текущее удостоверение области отслеживания (TAI). Это поле используется только для NDIS_WWAN_PACKET_SERVICE_STATE_REVISION_3.

Rel3GppVer

0xFFFFFFFF будет использоваться, если неизвестно. Неизвестно, либо MBIM_TLV_TYPE_3GPP_REL_VERSION не содержится в MBIM_PACKET_SERVICE_INFO_V3, устройство напрямую возвращает 0xFFFFFFFF, либо устройство использует MBIM 3.0 или более раннее.

Замечания

Текущее состояние службы подключения пакетов обычно отражается в пользовательском интерфейсе устройства.

Служба MB объединяет классы данных, представленные в AvailableDataClass с поддерживаемыми классами данных, сообщаемыми с возможностями устройства для отображения пересечения доступных вариантов пользователю.

Если устройство также поддерживает класс данных, отличный от предопределенных значений в элементе WwanDataClass члена WWAN_DEVICE_CAPS, драйвер минипорта должен задать флаг WWAN_DATA_CLASS_CUSTOM вместе с соответствующим битовой маской, определенной для класса данных в этом члене.

запрос и задать запросы OID, а также события состояния без оболоченных состояний используют элемент uNwError. Если нет определенной сети ошибки или не известной ошибки конкретной сети, драйверы мини-порта должны задать для этого члена значение нулю. В разделе "Структура указания состояния" в МБ семантика операционной показана ошибка подключения пакетов или отсоединения пакетов, которые определены в спецификации 3GPP TS 24.008.

Ниже приведены рекомендации по возврату ошибки конкретной сети в разных сценариях:

  • Если операция подключения пакетов завершается сбоем из-за ошибки конкретной сети, драйверы минипорта должны вернуть ошибку конкретной сети в ответ на запросы запросов. В этом случае драйверы минипорта должны задать для элемента uStatus в структуре NDIS_WWAN_PACKET_SERVICE_STATE значение WWAN_STATUS_SUCCESS и задать элемент uNwError в код ошибки конкретной сети.
  • Если задать запрос завершается ошибкой, драйверы мини-порта должны вернуть код ошибки конкретной сети. В этом случае драйверы минипорта должны задать элемент uStatus структуры NDIS_WWAN_PACKET_SERVICE_STATE для WWAN_STATUS_FAILURE и задать элемент uNwError в код ошибки конкретной сети.
  • Всякий раз, когда состояние регистрации устройства изменяется, так как сетевой пакет отсоединяет устройство, то события состояния незапрошенного состояния должны включать в себя ошибку конкретной сети. В этом случае драйвер минипорта должен задать элемент uStatus в структуре NDIS_WWAN_PACKET_SERVICE_STATE WWAN_STATUS_SUCCESS и задать элемент uNwError в коде ошибки конкретной сети.
Минипорт-драйверы могут предоставлять дополнительные коды ошибок, определенные спецификацией стандартов GSM кодов ошибок подключения пакетов, возвращаемых сетью. Например, минипорт-драйверы могут взаимодействовать со спецификацией 3GPP TS 24.008 с кодами ошибок подключения пакетов, например код ошибки 12 (область расположения не разрешено), службе МБ через uNwError.

Драйверы минипорта должны сообщать код причины в самом раннем экземпляре. Например, если устройство MB обнаруживает один из этих кодов при попытке зарегистрировать устройство в сетевом поставщике, мини-драйвер должен сообщить об этом.

Требования

Требование Ценность
минимальные поддерживаемые клиентские Доступно в Windows 7 и более поздних версиях Windows.
заголовка wwan.h (include Wwan.h)

См. также

NDIS_WWAN_PACKET_SERVICE_STATE

WWAN_PACKET_SERVICE_STATE