OID_WWAN_DEVICE_CAPS_EX
OID_WWAN_DEVICE_CAPS_EX è simile a OID_WWAN_DEVICE_CAPS , ma è un OID per executor, a differenza di OID_WWAN_DEVICE_CAPS che è un OID per dispositivo. Questo OID serve a indicare la funzionalità dispositivo/executor dell'hardware, inclusa la funzionalità su funzionalità facoltative estese, ad esempio la configurazione APN di collegamento LTE.
I driver Miniport devono elaborare le richieste di query in modo asincrono, restituendo inizialmente NDIS_STATUS_INDICATION_REQUIRED alla richiesta originale prima di inviare successivamente una notifica di stato NDIS_STATUS_WWAN_DEVICE_CAPS_EX contenente una struttura di NDIS_WWAN_DEVICE_CAPS_EX , che a sua volta contiene una struttura di WWAN_DEVICE_CAPS_EX , per fornire informazioni sulla funzionalità del dispositivo.
Il diagramma seguente illustra una richiesta di query.
Le richieste set non sono applicabili.
Commenti
È fondamentale per il driver segnalare la funzionalità di estensione del servizio nel suo complesso, incluso dal driver al dispositivo effettivo. Se un driver supporta un servizio ma non è supportato dall'hardware sottostante, le funzionalità del servizio devono essere contrassegnate come FALSE.
OID_WWAN_DEVICE_CAPS_EX viene usato anche per recuperare la funzionalità di ogni executor. Questo OID è lo stesso nella struttura di OID_WWAN_DEVICE_CAPS esistente, ma con l'aggiunta dell'ID executor. Un driver miniport deve segnalare la versione OID più recente supportata.
Come per OID_WWAN_DEVICE_CAPS, i parametri in questo OID non dovrebbero cambiare a causa delle schede SIM, ma rappresentano invece la funzionalità RF del modem dell'executor selezionato. Un modem hardware fisico può avere più executor e quindi può avere più interfacce che supportano OID_WWAN_DEVICE_CAPS_EX.
Per i possibili aggiornamenti futuri, se la versione richiesta del sistema operativo è più recente rispetto alla versione supportata dal dispositivo, il dispositivo deve restituire la versione più recente della struttura OID supportata. Se la versione richiesta del sistema operativo è precedente a quella più recente supportata dal dispositivo, il dispositivo deve restituire la versione corrispondente alla specifica del sistema operativo. Per garantire che tutte le revisioni di OID_WWAN_DEVICE_CAPS_EX siano supportate per la compatibilità con le versioni precedenti e il supporto legacy, è un requisito per IHDV.
A differenza di altri OID nuovi per Windows 10 versione 1703 che sono necessari solo se il modem supporta multi-SIM/multi-executor, questo OID deve essere implementato per i modem che vogliono supportare qualsiasi estensione di servizio definita da Microsoft a partire da Windows 10 versione 1703.
Le versioni di Windows precedenti a Windows 10 versione 1703 possono comunque usare l'OID_WWAN_DEVICE_CAPS esistente. Il comportamento con modem con supporto per più executor non è uno scenario supportato. Gli IHD devono definire questo comportamento.
Windows 10, versione 1903
A partire da Windows 10 versione 1903, OID_WWAN_DEVICE_CAPS_EX è stato aggiornato alla revisione 2. Un driver miniport deve usare la revisione 2 di questo OID e le strutture di dati contenute se il driver miniport supporta 5G.
Quando l'host esegue query sulle funzionalità che usano questo OID, il driver miniport deve verificare se l'hardware sottostante supporta le funzionalità della rete cellulare 5G. In caso affermativo, il driver miniport imposta la maschera di bit nel campo WwanDataClass della struttura WWAN_DEVICE_CAPS_EX in base alle capabilties hardware.
Inoltre, nel campo WwanOptionalServiceCaps della struttura WWAN_DEVICE_CAPS_EX viene definito un nuovo bit di servizio facoltativo che copre il supporto di tutte le nuove estensioni correlate al 5G.
Per altre informazioni sul supporto della classe di dati 5G, vedi Supporto della classe di dati MB 5G.
Requisiti
Versione |
Windows 10 versione 1703 |
Intestazione |
Ntddndis.h (include Ndis.h) |