OID_WWAN_DEVICE_CAPS_EX
OID_WWAN_DEVICE_CAPS_EX liknar OID_WWAN_DEVICE_CAPS men är en OID per exekutor, till skillnad från OID_WWAN_DEVICE_CAPS som är en OID per enhet. Den här OID-funktionen anger maskinvarans enhets-/körfunktion, inklusive funktionen för utökade valfria funktioner som LTE-anslutnings-APN-konfiguration.
Miniportdrivrutiner måste bearbeta frågebegäranden asynkront, vilket ursprungligen returnerar NDIS_STATUS_INDICATION_REQUIRED till den ursprungliga begäran innan du senare skickar ett NDIS_STATUS_WWAN_DEVICE_CAPS_EX statusmeddelande som innehåller en NDIS_WWAN_DEVICE_CAPS_EX struktur, som i sin tur innehåller en WWAN_DEVICE_CAPS_EX struktur. för att ge information om enhetens kapacitet.
Följande diagram illustrerar en frågebegäran.
Ange begäranden är inte tillämpliga.
Anmärkningar
Det är viktigt att drivrutinen rapporterar funktioner för tjänsttillägg som helhet, inklusive från drivrutinen till den faktiska enheten. Om en drivrutin stöder en tjänst, men den inte stöds av den underliggande maskinvaran, bör tjänstfunktionerna markeras som FALSE.
OID_WWAN_DEVICE_CAPS_EX används också för att hämta varje körfunktion. Denna OID är samma i strukturen som befintliga OID_WWAN_DEVICE_CAPS men med tillägg av Executor ID. En miniportdrivrutin bör rapportera den högsta OID-version som den stöder.
Precis som med OID_WWAN_DEVICE_CAPSförväntas parametrarna i denna OID inte ändras på grund av SIM-kort, utan representerar snarare modemets RF-kapacitet för den valda kören. Ett fysiskt maskinvarumodem kan ha flera körbara filer och kan därför ha flera gränssnitt som stöder OID_WWAN_DEVICE_CAPS_EX.
Om operativsystemets begärda version är nyare än den version som stöds av enheten ska enheten returnera den senaste versionen av den OID-struktur som den stöder för eventuella framtida uppdateringar. Om operativsystemets begärda version är äldre än den senaste som stöds av enheten ska enheten returnera den version som matchar operativsystemets specifikation. Det är ett krav för IHV:er att se till att alla revisioner av OID_WWAN_DEVICE_CAPS_EX stöds för bakåtkompatibilitet och äldre stöd.
Till skillnad från andra OID:er som är nya för Windows 10 version 1703 och som endast krävs om modemet stöder multi-SIM/multi-executors, måste denna OID implementeras för modem som vill stödja microsoft-definierade tjänsttillägg som börjar i Windows 10 version 1703.
Versioner av Windows före Windows 10 version 1703 kan fortfarande använda den befintliga OID_WWAN_DEVICE_CAPS; deras beteende med modem som kan köras med flera utförare är inte ett scenario som stöds. IHV:er måste definiera det här beteendet.
Windows 10, version 1903
Från och med Windows 10 version 1903 har OID_WWAN_DEVICE_CAPS_EX uppgraderats till revision 2. En miniportdrivrutin måste använda revision 2 av denna OID och de datastrukturer som den innehåller om miniportdrivrutinen stöder 5G.
När värden frågar efter funktioner med den här OID:en måste miniportdrivrutinen kontrollera om den underliggande maskinvaran stöder 5G-mobilfunktioner. Om den gör det anger miniportdrivrutinen bitmasken i fältet WwanDataClass i WWAN_DEVICE_CAPS_EX-strukturen enligt maskinvarukapabilties.
I fältet WwanOptionalServiceCaps i WWAN_DEVICE_CAPS_EX-strukturen definieras dessutom en ny valfri tjänstbit som omfattar stöd för alla nya 5G-relaterade tillägg.
Mer information om stöd för 5G-dataklass finns i MB 5G-dataklassstöd.
Krav
Version |
Windows 10, version 1703 |
Rubrik |
Ntddndis.h (inkludera Ndis.h) |