OID_WWAN_DEVICE_CAPS_EX
OID_WWAN_DEVICE_CAPS_EX jest podobny do OID_WWAN_DEVICE_CAPS, ale jest identyfikatorem OID funkcji wykonawczej, w przeciwieństwie do OID_WWAN_DEVICE_CAPS, który jest identyfikatorem OID poszczególnych urządzeń. Ten identyfikator OID służy do wskazywania możliwości urządzenia/funkcji wykonawczej sprzętu, w tym możliwości rozszerzonych funkcji opcjonalnych, takich jak konfiguracja APN dołączania LTE.
Sterowniki miniportu muszą przetwarzać żądania zapytań asynchronicznie, początkowo zwracając NDIS_STATUS_INDICATION_REQUIRED do oryginalnego żądania przed wysłaniem później powiadomienia o stanie NDIS_STATUS_WWAN_DEVICE_CAPS_EX zawierającego strukturę NDIS_WWAN_DEVICE_CAPS_EX, która z kolei zawiera strukturę WWAN_DEVICE_CAPS_EX, w celu udostępnienia informacji o możliwościach urządzenia.
Na poniższym diagramie przedstawiono żądanie zapytania.
Ustawianie żądań nie ma zastosowania.
Sterownik ma kluczowe znaczenie dla raportowania możliwości rozszerzenia usługi jako całości, w tym od sterownika do rzeczywistego urządzenia. Jeśli sterownik obsługuje usługę, ale nie jest obsługiwany przez podstawowy sprzęt, możliwości usługi powinny być oznaczone jako FALSE.
OID_WWAN_DEVICE_CAPS_EX służy również do pobierania możliwości każdego wykonawcy. Ten identyfikator OID jest taki sam w strukturze co istniejący OID_WWAN_DEVICE_CAPS, ale z dodatkiem identyfikatora funkcji wykonawczej . Sterownik miniportu powinien zgłaszać najwyższą obsługiwaną wersję identyfikatora OID.
Podobnie jak w przypadku OID_WWAN_DEVICE_CAPS, parametry w tym identyfikatorze OID nie powinny ulec zmianie z powodu kart SIM, ale raczej reprezentują możliwości RF modemu wybranego wykonawcy. Fizyczny modem sprzętowy może mieć wiele funkcji wykonawczych, a tym samym może mieć wiele interfejsów obsługujących OID_WWAN_DEVICE_CAPS_EX.
W przypadku możliwych przyszłych aktualizacji, jeśli żądana wersja systemu operacyjnego jest nowsza niż wersja obsługiwana przez urządzenie, urządzenie powinno zwrócić najnowszą wersję obsługiwanej struktury identyfikatora OID. Jeśli żądana wersja systemu operacyjnego jest starsza niż najnowsza obsługiwana przez urządzenie, urządzenie powinno zwrócić wersję zgodną ze specyfikacją systemu operacyjnego. Wymagane jest, aby IHV upewnić się, że wszystkie wersje OID_WWAN_DEVICE_CAPS_EX są obsługiwane w celu zapewnienia zgodności z poprzednimi wersjami i starszej wersji.
W przeciwieństwie do innych identyfikatorów OID nowych dla systemu Windows 10 w wersji 1703, które są wymagane tylko wtedy, gdy modem obsługuje multi-SIM/multi-wykonawcze, ten identyfikator OID musi być zaimplementowany dla modemów, które chcą obsługiwać wszystkie rozszerzenia usługi zdefiniowane przez firmę Microsoft począwszy od systemu Windows 10 w wersji 1703.
Wersje systemu Windows wcześniejsze niż Windows 10 w wersji 1703 mogą nadal używać istniejącego OID_WWAN_DEVICE_CAPS; ich zachowanie z modemami obsługującymi wiele funkcji wykonawczej nie jest obsługiwanym scenariuszem. Woluminy IHV muszą definiować to zachowanie.
Począwszy od systemu Windows 10, wersja 1903, OID_WWAN_DEVICE_CAPS_EX został uaktualniony do wersji 2. Sterownik miniportu musi używać poprawki 2 tego identyfikatora OID i struktur danych, które zawiera, jeśli sterownik miniport obsługuje 5G.
Jeśli host wysyła zapytania dotyczące możliwości przy użyciu tego identyfikatora OID, sterownik miniportu musi sprawdzić, czy podstawowy sprzęt obsługuje możliwości sieci komórkowej 5G. Jeśli tak, sterownik miniportu ustawia maskę bitów w WwanDataClass pola struktury WWAN_DEVICE_CAPS_EX zgodnie z capabilties sprzętu.
Ponadto w polu WwanOptionalServiceCaps struktury WWAN_DEVICE_CAPS_EX zdefiniowano nowy opcjonalny bit usługi, który obejmuje obsługę wszystkich nowych rozszerzeń związanych z siecią 5G.
Aby uzyskać więcej informacji na temat obsługi klas danych 5G, zobacz obsługa klas danych MB 5G.
Wersja |
Windows 10, wersja 1703 |
Nagłówek |
Ntddndis.h (m.in. Ndis.h) |