OID_WWAN_PROVISIONED_CONTEXTS
OID_WWAN_PROVISIONED_CONTEXTS lê ou atualiza as entradas de contexto provisionadas armazenadas no dispositivo MB ou no SIM (Módulo de Identidade do Assinante).
Os drivers de miniport devem processar solicitações de definição e consulta de forma assíncrona, retornando inicialmente NDIS_STATUS_INDICATION_REQUIRED para a solicitação original e, posteriormente, enviando um NDIS_STATUS_WWAN_PROVISIONED_CONTEXTS status notificação contendo uma estrutura NDIS_WWAN_PROVISIONED_CONTEXTS para fornecer informações sobre entradas de contexto provisionadas armazenadas no dispositivo MB ou no SIM (Módulo de Identidade do Assinante), independentemente de concluir solicitações de conjunto ou consulta.
Comentários
Para obter mais informações sobre como usar esse OID, consulte Gerenciamento de contexto de pacote WWAN.
Os drivers de miniporta devem retornar NDIS_STATUS_NOT_SUPPORTED se o dispositivo MB ao qual eles dão suporte não oferecer suporte à recuperação de contextos provisionados.
Os dispositivos baseados em GSM podem, opcionalmente, dar suporte a operações de consulta e de definição. Os dispositivos baseados em CDMA podem, opcionalmente, dar suporte a operações de consulta que relatam IP simples (WWAN_CTRL_CAPS_CDMA_SIMPLE_IP).
As entradas de contexto provisionadas armazenadas no dispositivo MB ou no SIM são locais para o dispositivo. Os drivers de miniporta não devem se conectar à rede para ler nesses campos.
A estrutura de entrada de uma solicitação definida é NDIS_WWAN_SET_PROVISIONED_CONTEXT e status indicação desse objeto é NDIS_STATUS_WWAN_PROVISIONED_CONTEXTS.
Os contextos provisionados não são iguais aos das definições de contexto do GPRS no 3GPP que armazenam em cache a lista de APNs. Os contextos provisionados são os parâmetros de conectividade (AccessString, UserName e Password) que são pré-provisionados pelos Operadores ou OTA provisionados pelo dispositivo e podem ser armazenados na memória do dispositivo ou no SIM. Os parâmetros de conectividade retornados pelos contextos provisionados serão usados pelo Serviço MB para ativação PDP.
A consulta e a forma definida desse objeto são usadas.
O processamento dessa solicitação não requer acesso à rede, mas requer acesso ao SIM ou à memória auxiliar no dispositivo MB.
O driver de miniporta envia NDIS_STATUS_WWAN_PROVISIONED_CONTEXTS notificação para o sistema operacional. O membro ContextListHeader.ElementType deve ser definido como WwanStructContext. O driver miniport deve definir o membro ContextListHeader.ElementCount como 0 quando a notificação for enviada em resposta a uma solicitação definida.
O Serviço MB deve recuperar a lista de contextos provisionados do dispositivo antes de conduzir qualquer ativação ou desativação de contexto individual. A lista de contextos provisionados deve ser restrita somente à rede do provedor doméstico, embora o dispositivo possa ter a capacidade de armazenar vários contextos de provedor de rede. A lista de contexto sempre deve ser a rede do provedor inicial específica, mesmo em caso de roaming.
SET OID_WWAN_PROVISIONED_CONTEXT operação deve associar o contexto ao provedor de rede especificado na solicitação set no membro ProviderId da estrutura WWAN_SET_CONTEXT. Contexto provisionado armazenado por meio do conjunto OID_WWAN_PROVISIONED_CONTEXT solicitações devem persistir entre reinicializações do sistema e reciclagems de energia do dispositivo.
Todos os contextos vazios precisam ser relatados em uma consulta junto com os contextos provisionados aplicáveis à rede do provedor doméstico.
Dispositivos CDMA configurados para SimpleIP, relatórios em WWAN_CTRL_CAPS_CDMA_SIMPLE_IP no WwanControlCaps podem, opcionalmente, retornar pelo menos um contexto provisionado preenchido com os membros AccessString, UserName e Password corretos para a solicitação de consulta do Serviço MB.
A lista de contexto provisionada deve ser pré-provisionada no dispositivo, atualizada por conjunto OID_WWAN_PROVISIONED_CONTEXT operações ou atualizada pelo dispositivo/operador usando SMS ou OTA. Ele não deve ser atualizado dinamicamente com base nas informações de contexto fornecidas na operação de OID_WWAN_CONNECT pelo Serviço MB.
Para obter mais informações sobre como acessar AccessString, UserName e Password do dispositivo MB para cada contexto provisionado na lista, consulte WWAN_CONTEXT.
Requisitos
Versão |
Disponível no Windows 7 e versões posteriores do Windows. |
Cabeçalho |
Ntddndis.h (inclua Ndis.h) |