OID_WWAN_DEVICE_CAPS_EX

OID_WWAN_DEVICE_CAPS_EX é semelhante a OID_WWAN_DEVICE_CAPS mas é uma OID por executor, ao contrário de OID_WWAN_DEVICE_CAPS que é uma OID por dispositivo. Essa 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 do LTE.

Os drivers de miniport devem processar solicitações de consulta de forma assíncrona, inicialmente retornando NDIS_STATUS_INDICATION_REQUIRED à solicitação original antes de enviar uma notificação de status NDIS_STATUS_WWAN_DEVICE_CAPS_EX contendo uma estrutura de 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 conjunto não são aplicáveis.

Observações

É fundamental 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 tiver suporte pelo 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. Essa OID é a mesma em estrutura que a OID_WWAN_DEVICE_CAPS existente, mas com a adição de ID do Executor. Um driver de miniporto deve relatar a versão mais alta do OID compatível.

Assim como acontece com OID_WWAN_DEVICE_CAPS, os parâmetros nesta 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 compatível com o 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 os IHVs garantirem 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, essa OID deve ser implementada 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_CAPSexistente; 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 miniporto deve usar a revisão 2 dessa OID e as estruturas de dados que ele contém se o driver de miniporto der suporte a 5G.

Quando o host consulta os recursos usando essa OID, o driver de miniporto deve verificar 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

Consulte também

OID_WWAN_DEVICE_CAPS

NDIS_STATUS_WWAN_DEVICE_CAPS_EX

NDIS_WWAN_DEVICE_CAPS_EX

WWAN_DEVICE_CAPS_EX