структура 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 в коде ошибки конкретной сети.
Драйверы минипорта должны сообщать код причины в самом раннем экземпляре. Например, если устройство MB обнаруживает один из этих кодов при попытке зарегистрировать устройство в сетевом поставщике, мини-драйвер должен сообщить об этом.
Требования
Требование | Ценность |
---|---|
минимальные поддерживаемые клиентские | Доступно в Windows 7 и более поздних версиях Windows. |
заголовка | wwan.h (include Wwan.h) |