OID_WWAN_DEVICE_CAPS_EX
OID_WWAN_DEVICE_CAPS_EX é semelhante a OID_WWAN_DEVICE_CAPS , mas é um OID por executor, ao contrário de OID_WWAN_DEVICE_CAPS que é um OID por dispositivo. Esse OID serve para indicar a funcionalidade de dispositivo/executor do hardware, incluindo a funcionalidade em recursos opcionais estendidos, como a configuração de APN de anexação LTE.
Os drivers de miniport devem processar solicitações de consulta de forma assíncrona, retornando inicialmente NDIS_STATUS_INDICATION_REQUIRED à solicitação original antes de enviar uma notificação NDIS_STATUS_WWAN_DEVICE_CAPS_EX status que contém uma estrutura NDIS_WWAN_DEVICE_CAPS_EX, que por sua vez contém uma estrutura WWAN_DEVICE_CAPS_EX, para fornecer informações sobre a funcionalidade do dispositivo.
O diagrama a seguir ilustra uma solicitação de consulta.
As solicitações de definição não são aplicáveis.
Comentários
É essencial que o driver relate a funcionalidade de extensão de serviço como um todo, incluindo do driver para o dispositivo real. Se um driver der suporte a um serviço, mas não for compatível com o hardware subjacente, os recursos de serviço deverão ser marcados como FALSE.
OID_WWAN_DEVICE_CAPS_EX também é usado para recuperar a funcionalidade de cada executor. Esse OID é o mesmo na estrutura que os OID_WWAN_DEVICE_CAPS existentes, mas com a adição da ID do Executor. Um driver de miniporta deve relatar a versão mais alta do OID à qual ele dá suporte.
Assim como acontece com OID_WWAN_DEVICE_CAPS, os parâmetros nesse OID não devem ser alterados devido a cartões SIM, mas representam a funcionalidade RF do modem do executor selecionado. Um modem de hardware físico pode ter vários executores e, portanto, pode ter várias interfaces que dão suporte a OID_WWAN_DEVICE_CAPS_EX.
Para possíveis atualizações futuras, se a versão solicitada do sistema operacional for mais recente do que a versão com suporte do dispositivo, o dispositivo deverá retornar a versão mais recente da estrutura OID compatível. Se a versão solicitada do sistema operacional for mais antiga do que a mais recente compatível com o dispositivo, o dispositivo deverá retornar a versão correspondente à especificação do sistema operacional. É um requisito para IHVs garantir que todas as revisões de OID_WWAN_DEVICE_CAPS_EX sejam compatíveis com compatibilidade com versões anteriores e suporte herdado.
Ao contrário de outros OIDs novos no Windows 10 versão 1703 que só são necessários se o modem dá suporte a vários SIM/multi-executores, esse OID deve ser implementado para modems que gostariam de dar suporte a quaisquer extensões de serviço definidas pela Microsoft a partir do Windows 10 Versão 1703.
Versões do Windows anteriores ao Windows 10 versão 1703 ainda podem usar o OID_WWAN_DEVICE_CAPS existente; seu comportamento com modems compatíveis com vários executores não é um cenário com suporte. Os IHVs devem definir esse comportamento.
Windows 10, versão 1903
A partir do Windows 10, versão 1903, OID_WWAN_DEVICE_CAPS_EX foi atualizado para a revisão 2. Um driver de miniporta deve usar a revisão 2 desse OID e as estruturas de dados que ele contém se o driver de miniporto der suporte a 5G.
Quando o host consulta recursos usando esse OID, o driver de miniporta deve marcar se o hardware subjacente dá suporte a recursos de celular 5G. Se isso acontecer, o driver de miniporto definirá a máscara de bits no campo WwanDataClass da estrutura WWAN_DEVICE_CAPS_EX de acordo com as capacidades de hardware.
Além disso, no campo WwanOptionalServiceCaps da estrutura WWAN_DEVICE_CAPS_EX , um novo bit de serviço opcional é definido que abrange o suporte de todas as novas extensões relacionadas ao 5G.
Para obter mais informações sobre o suporte à classe de dados 5G, consulte Suporte à classe de dados MB 5G.
Requisitos
Versão |
Windows 10, versão 1703 |
Cabeçalho |
Ntddndis.h (inclua Ndis.h) |