estructura NDIS_WWAN_CONTEXT_STATE (ndiswwan.h)
La estructura NDIS_WWAN_CONTEXT_STATE representa el estado de contexto del protocolo de datos de paquetes (PDP) del dispositivo MB.
Sintaxis
typedef struct _NDIS_WWAN_CONTEXT_STATE {
NDIS_OBJECT_HEADER Header;
WWAN_STATUS uStatus;
WWAN_CONTEXT_STATE ContextState;
} NDIS_WWAN_CONTEXT_STATE, *PNDIS_WWAN_CONTEXT_STATE;
Miembros
Header
Encabezado con información de tipo, revisión y tamaño sobre la estructura NDIS_WWAN_CONTEXT_STATE. El servicio MB establece el encabezado con los valores que se muestran en la tabla siguiente cuando envía la estructura de datos al controlador de miniport para establecer operaciones. Los controladores de miniport deben establecer el encabezado con los mismos valores cuando envían la estructura de datos al servicio MB.
| Submember de encabezado | Valor |
|---|---|
| Tipo | NDIS_OBJECT_TYPE_DEFAULT |
| Revisión | Los controladores de minipuerto de Windows 8 deben establecerlo en NDIS_WWAN_CONTEXT_STATE_REVISION_2. Los controladores de miniporte de Windows 7 deben establecerlo en NDIS_WWAN_CONTEXT_STATE_REVISION_1. |
| Tamaño | sizeof(NDIS_WWAN_CONTEXT_STATE) |
Para obtener más información sobre estos miembros, vea NDIS_OBJECT_HEADER.
uStatus
Estado de la operación de activación o desactivación del contexto. En la tabla siguiente se muestran los valores posibles para este miembro.
| Valor | Significado |
|---|---|
| WWAN_STATUS_SUCCESS | Activación o desactivación de contexto realizada correctamente. |
| WWAN_STATUS_FAILURE | Error en la operación. Los controladores de miniport pueden devolver este valor si el contexto ya se ha activado. |
| WWAN_STATUS_PIN_REQUIRED | Error en la operación porque el dispositivo requiere un PIN. |
| WWAN_STATUS_BAD_SIM | Error en la operación porque se detectó una tarjeta SIM incorrecta. |
| WWAN_STATUS_SIM_NOT_INSERTED | Error en la operación porque la tarjeta SIM no se insertó completamente en el dispositivo. |
| WWAN_STATUS_NOT_INITIALIZED | Error en la operación porque el dispositivo está en proceso de inicialización. Vuelva a intentar la operación después de que el estado listo del dispositivo cambie a WwanReadyStateInitialized. |
Los controladores de miniport pueden devolver los siguientes códigos de error (además de los descritos anteriormente) solo en caso de que se produzca un error en una operación de activación PDP establecida.
| Valor | Significado |
|---|---|
| WWAN_STATUS_RADIO_POWER_OFF | Error en la operación porque la radio está desactivada actualmente. Este código de error solo debe devolverse en respuesta a un OID_WWAN_CONNECT establecer solicitud. Si el estado de radio está desactivado, el controlador de miniport debe responder a OID_WWAN_CONNECT consulta solicitudes con WWAN_STATUS_SUCCESS y especificar el estado de contexto actual como WwanActivationStateDeactivated. |
| WWAN_STATUS_SERVICE_NOT_ACTIVATED | Error en la operación porque la suscripción ha expirado o el dispositivo no permite la activación de PDP. |
| WWAN_STATUS_PROVIDER_NOT_VISIBLE | Error en la operación porque el proveedor de servicios no está visible actualmente. |
| WWAN_STATUS_MAX_ACTIVATED_CONTEXTS | Error en la operación porque se ha alcanzado el número máximo de contextos activados. |
| WWAN_STATUS_INVALID_ACCESS_STRING | Error en la operación porque la cadena de acceso no es válida. |
| WWAN_STATUS_INVALID_USER_NAME_PWD | Error en la operación porque el nombre de usuario o la contraseña proporcionados no son válidos. El código de error específico de la red puede estar disponible en uNwError . |
| WWAN_STATUS_PACKET_SVC_DETACHED | Error en la operación porque el servicio de paquetes está desasociado. |
| WWAN_STATUS_NOT_REGISTERED | Error en la operación porque el dispositivo no está en estado registrado para realizar la activación de PDP. |
| WWAN_STATUS_VOICE_CALL_IN_PROGRESS | Error en la operación y no puede continuar con la activación de PDP porque una llamada de voz está actualmente en curso. Este valor solo se aplica a los dispositivos con clase de voz se establece en WwanVoiceClassSeparateVoiceData. |
| WWAN_STATUS_CONTEXT_NOT_ACTIVATED | Error en la operación porque el contexto identificado por ConnectionId no es el contexto activado actualmente. |
ContextState
Objeto WWAN_CONTEXT_STATE con formato que representa el estado de contexto del protocolo de datos de paquetes (PDP) del dispositivo.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Disponible en Windows 7 y versiones posteriores de Windows. |
| encabezado de | ndiswwan.h (incluya Ndiswwan.h) |