OID_WWAN_CONNECT
OID_WWAN_CONNECT activa o desactiva un contexto de paquete determinado y lee el estado de activación de un contexto.
Los controladores de minipuerto deben procesar las solicitudes de establecimiento y consulta de forma asincrónica, devolviendo inicialmente NDIS_STATUS_INDICATION_REQUIRED a la solicitud original y, posteriormente, enviando una notificación de estado NDIS_STATUS_WWAN_CONTEXT_STATE que contiene una estructura de NDIS_WWAN_CONTEXT_STATE que indica el estado de contexto del protocolo de datos de paquetes (PDP) del dispositivo MB, independientemente de completar las solicitudes de conjunto o consulta.
Los autores de llamadas que solicitan establecer el estado de contexto del protocolo de datos de paquetes (PDP) del dispositivo MB proporcionan una estructura de NDIS_WWAN_SET_CONTEXT_STATE al controlador de miniporte con la información adecuada.
Observaciones
Para obtener más información sobre el uso de este OID, vea WWAN Packet Context Management.
Este objeto activa o desactiva un contexto de paquete determinado y lee el estado de activación de un contexto. El controlador de minipuerto debe enviar notificaciones de eventos adecuadas cada vez que cambie el estado de activación.
Este objeto se llama solo si el controlador de minipuerto está en un estado de registro de WwanRegisterStateHome, WwanRegisterStatePartner o WwanRegisterStateRoaming. Cuando el servicio de paquetes está activo, el dispositivo también debe estar en un estado de conexión de WwanPacketServiceStateAttached.
Tanto las operaciones set como query son compatibles con este objeto.
El procesamiento de una solicitud set requiere acceso de red, pero no acceso SIM.
El procesamiento de una solicitud de consulta no requiere acceso a la red ni a la SIM.
La estructura de datos de este OID es NDIS_WWAN_SET_CONTEXT_STATE. El controlador de minipuerto emite una indicación de estado de NDIS_STATUS_WWAN_CONTEXT_STATE para las solicitudes de establecimiento y consulta.
En esta versión del modelo de controlador, el controlador de minipuerto intenta activar el contexto solo como se indica en el servicio MB. (Los controladores miniport pueden activar un contexto iniciado por la red en versiones posteriores). Los controladores de minipuerto no deben activar automáticamente un contexto incluso después de perder el registro o una señal. Si la cadena de acceso no se proporciona en la solicitud de activación, un controlador de minipuerto no debe intentar proporcionar una cadena predeterminada. En su lugar, debe continuar con la activación del contexto con una cadena de acceso en blanco.
Por otro lado, el controlador de minipuerto puede desactivar un contexto según lo indicado por el servicio MB. Esto puede ocurrir cuando se ha perdido la conectividad de red durante un período que supera el umbral de pérdida temporal de señal, o como parte de un apagado correcto o limpieza de estado.
Dado que solo se admite un contexto activado en esta versión, la activación o desactivación de un contexto determinado equivale a configurar o anular la conexión de capa 2 MB.
En las solicitudes establecidas, el servicio MB proporciona parámetros ConnectionId y ActivationCommand en la estructura de datos WWAN_CONTEXT_STATE. Indica al controlador de minipuerto que active o desactive un contexto de paquete identificado por ConnectionId, según el valor del parámetro ActivationCommandWwanActivationCommandActivate o WwanActivationCommandDeactivate.
Si el servicio o la suscripción requieren activación, el controlador de minipuerto debe devolver el código de error WWAN_STATUS_SERVICE_NOT_ACTIVATED. Es posible que la activación de PDP no se produzca hasta que se active el servicio o la suscripción. Es posible que todos los servicios de emergencia estén disponibles sujetos al soporte técnico del dispositivo y del operador. El sistema operativo podría llamar al OID_WWAN_SERVICE_ACTIVATION en respuesta a este código de error.
Si el controlador de minipuerto recibe una solicitud de activación de contexto mientras se activa otro contexto de paquete, devuelve el código de error WWAN_STATUS_MAX_ACTIVATED_CONTEXTS.
Si el controlador de minipuerto recibe una solicitud de desactivación de contexto, pero el contexto identificado por ConnectionId no está activado actualmente, devuelve el código de error WWAN_STATUS_CONTEXT_NOT_ACTIVATED.
El controlador de minipuerto usa la siguiente lógica para determinar la validez de la configuración accessString, UserName y Password de una solicitud establecida:
- Si ActivationCommand es WwanActivationCommandDeactivate, el controlador de minipuerto debe omitir la configuración de estos tres parámetros. El resto de los casos solo tiene en cuenta el caso cuando ActivationCommand es WwanActivationCommandActivate.
La activación de contexto persiste en el inicio de sesión y el inicio de sesión del usuario. No es por usuario de inicio de sesión.
En las solicitudes de consulta, el servicio MB usa este objeto para averiguar el estado de activación.
Para responder a las solicitudes de consulta, el controlador de minipuerto envía la notificación NDIS_STATUS_WWAN_CONTEXT_STATE.
Importante Nota:
En raras circunstancias, pero específicas, el servicio MB en Windows 7 puede intentar conectarse automáticamente antes de que se haya determinado la conectividad a Internet para las conexiones preexistentes o durante una interrupción momentánea en la conectividad a Internet de conexiones preexistentes. Esto podría dar lugar a conexiones MB y WLAN/Ethernet simultáneas. Por ejemplo, esto puede producirse durante el arranque del sistema cuando se intentan mb y otras conexiones simultáneamente y el servicio Network List Manager sigue intentando determinar la conectividad a Internet de otras conexiones mediante métodos activos y pasivos. También podría producirse debido a interrupciones temporales en la infraestructura de red, como un servidor proxy corporativo o una red ISP. Por lo tanto, el servicio MB puede intentar conectarse automáticamente a Internet independientemente de si está seleccionada la opción "Conexión automática solo si no hay ninguna conexión a Internet alternativa disponible".
Requisitos
Versión |
Disponible en Windows 7 y versiones posteriores de Windows. |
Encabezado |
Ntddndis.h (incluye Ndis.h) |