OID_WWAN_PROVISIONED_CONTEXTS
OID_WWAN_PROVISIONED_CONTEXTS lê ou atualiza as entradas de contexto provisionadas armazenadas no dispositivo MB ou no SIM (Subscriber Identity Module).
Os drivers de miniporta devem processar solicitações de conjunto e consulta de forma assíncrona, inicialmente retornando NDIS_STATUS_INDICATION_REQUIRED à solicitação original e, posteriormente, enviando uma notificação de status de NDIS_STATUS_WWAN_PROVISIONED_CONTEXTS contendo uma estrutura de NDIS_WWAN_PROVISIONED_CONTEXTS para fornecer informações sobre entradas de contexto provisionadas armazenadas no dispositivo MB ou no SIM (Subscriber Identity Module), independentemente da conclusão de solicitações de conjunto ou consulta.
Comentários
Para obter mais informações sobre como usar esse OID, consulte WWAN Packet Context Management.
Os drivers de miniporta devem retornar NDIS_STATUS_NOT_SUPPORTED se o dispositivo MB suportado não oferecer suporte à recuperação de contextos provisionados.
Os dispositivos baseados em GSM podem, opcionalmente, suportar operações de consulta e definição. Os dispositivos baseados em CDMA podem, opcionalmente, suportar operações de consulta relatando 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 para uma solicitação de conjunto é NDIS_WWAN_SET_PROVISIONED_CONTEXT e a indicação de status desse objeto é NDIS_STATUS_WWAN_PROVISIONED_CONTEXTS.
Os contextos provisionados não são iguais aos das definições de contexto GPRS no 3GPP que armazena em cache a lista de APNs. 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 forma de consulta e de conjunto deste objeto é usada.
O processamento deste pedido 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 de miniporta deve definir o membro ContextListHeader.ElementCount como 0 quando a notificação é enviada em resposta a uma solicitação definida.
O Serviço MB deve recuperar a lista de contextos provisionados do dispositivo antes de realizar qualquer ativação ou desativação de contexto individual. A lista de contextos provisionados deve ser restrita apenas à rede do provedor doméstico, mesmo que o dispositivo possa ter a capacidade de armazenar vários contextos de provedor de rede. A lista de contextos deve ser sempre específica da rede do fornecedor doméstico, mesmo em caso de roaming.
A operação SET OID_WWAN_PROVISIONED_CONTEXT deve associar o contexto ao provedor de rede especificado na solicitação set em ProviderId membro da estrutura WWAN_SET_CONTEXT. O contexto provisionado armazenado por meio de solicitações de OID_WWAN_PROVISIONED_CONTEXT definidas deve persistir nas reinicializações do sistema e nas reciclagens de energia do dispositivo.
Todos os contextos vazios precisam ser relatados em uma consulta, juntamente com os contextos provisionados aplicáveis à rede do provedor doméstico.
Os 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 o AccessStringcorreto, de Nome de Usuário e membros do de senha 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. Não deve ser atualizado dinamicamente com base nas informações de contexto fornecidas na operação 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.
Requerimentos
Versão |
Disponível no Windows 7 e versões posteriores do Windows. |
Cabeçalho |
Ntddndis.h (inclui Ndis.h) |