OID_WWAN_CONNECT

OID_WWAN_CONNECT attiva o disattiva un contesto di pacchetto specifico e legge lo stato di attivazione di un contesto.

I driver Miniport devono elaborare le richieste di set e di query in modo asincrono, restituendo inizialmente NDIS_STATUS_INDICATION_REQUIRED alla richiesta originale e successivamente inviando una notifica di stato NDIS_STATUS_WWAN_CONTEXT_STATE contenente una struttura di NDIS_WWAN_CONTEXT_STATE che indica lo stato del contesto PDP (Packet Data Protocol) del dispositivo MB indipendentemente dal completamento delle richieste impostate o di query.

I chiamanti che richiedono di impostare lo stato del contesto PDP (Packet Data Protocol) del dispositivo MB forniscono una struttura NDIS_WWAN_SET_CONTEXT_STATE al driver miniport con le informazioni appropriate.

Commenti

Per altre informazioni sull'uso di questo OID, vedere WWAN Packet Context Management.For more information about using this OID, see WWAN Packet Context Management.

Questo oggetto attiva o disattiva un contesto di pacchetto specifico e legge lo stato di attivazione di un contesto. Il driver miniport deve inviare notifiche di evento appropriate ogni volta che lo stato di attivazione cambia.

Questo oggetto viene chiamato solo se il driver miniport si trova in uno stato di registro WwanRegisterStateHome, WwanRegisterStatePartner o WwanRegisterStateRoaming. Quando il servizio pacchetti è attivo, il dispositivo deve trovarsi anche in uno stato di collegamento di WwanPacketServiceStateAttached.

Per questo oggetto sono supportate sia le operazioni set che le operazioni di query.

• L'elaborazione di una richiesta set richiede l'accesso alla rete, ma non l'accesso SIM.

• L'elaborazione di una richiesta di query non richiede l'accesso alla rete o alla SIM.

La struttura dei dati per questo OID è NDIS_WWAN_SET_CONTEXT_STATE. Il driver miniport genera un'indicazione dello stato di NDIS_STATUS_WWAN_CONTEXT_STATE per le richieste impostate e di query.

In questa versione del modello di driver, il driver miniport tenta l'attivazione del contesto solo come indicato dal servizio MB. I driver Miniport possono attivare un contesto avviato dalla rete nelle versioni successive. I driver Miniport non devono attivare automaticamente un contesto anche dopo aver perso la registrazione o un segnale. Se la stringa di accesso non viene specificata nella richiesta di attivazione, un driver miniport non deve tentare di fornire una stringa predefinita. Deve invece procedere con l'attivazione del contesto con una stringa di accesso vuota.

D'altra parte, il driver miniport può disattivare un contesto come indicato dal servizio MB. Ciò può verificarsi quando la connettività di rete è stata persa per un periodo che supera la soglia di perdita temporanea di segnale o come parte di un arresto normale o pulizia dello stato.

Poiché in questa versione è supportato un solo contesto attivato, l'attivazione o la disattivazione di un determinato contesto equivale a configurare o rimuovere la connessione di livello 2 MB.

Nelle richieste impostate, il servizio MB fornisce parametri ConnectionId e ActivationCommand nella struttura dei dati WWAN_CONTEXT_STATE. Indica al driver miniport di attivare o disattivare un contesto di pacchetto identificato da ConnectionId, in base al valore del parametro ActivationCommandWwanActivationCommandActivate o WwanActivationCommandDeactivate.

• Se il servizio o la sottoscrizione richiede l'attivazione, il driver miniport deve restituire il codice di errore WWAN_STATUS_SERVICE_NOT_ACTIVATED. L'attivazione PDP può verificarsi solo dopo l'attivazione del servizio o della sottoscrizione. Tutti i servizi di emergenza potrebbero essere disponibili in base al supporto del dispositivo e dell'operatore. Il sistema operativo potrebbe chiamare il OID_WWAN_SERVICE_ACTIVATION in risposta a questo codice di errore.

• Se il driver miniport riceve una richiesta di attivazione del contesto mentre è attualmente attivato un altro contesto di pacchetto, restituisce il codice di errore WWAN_STATUS_MAX_ACTIVATED_CONTEXTS.

• Se il driver miniport riceve una richiesta di disattivazione del contesto ma il contesto identificato da ConnectionId non è attualmente attivato, restituisce il codice di errore WWAN_STATUS_CONTEXT_NOT_ACTIVATED.

Il driver miniport usa la logica seguente per determinare la validità delle impostazioni AccessString, UserName e Password da una richiesta impostata:

• Se ActivationCommand è WwanActivationCommandDeactivate, il driver miniport deve ignorare le impostazioni di questi tre parametri. Il resto dei casi considera solo il caso in cui ActivationCommand è WwanActivationCommandActivate.

L'attivazione del contesto persiste tra l'accesso utente e la disconnessione. Non è per utente di accesso.

Nelle richieste di query, il servizio MB usa questo oggetto per individuare lo stato di attivazione.

Per rispondere alle richieste di query, il driver miniport invia la notifica NDIS_STATUS_WWAN_CONTEXT_STATE.

Importante Nota:

In rari casi, ma specifici, il servizio MB in Windows 7 può tentare di connettersi automaticamente prima che la connettività a Internet sia stata determinata per connessioni preesistenti o durante un'interruzione momentanea della connettività Internet delle connessioni preesistenti. Ciò potrebbe comportare connessioni MB e WLAN/Ethernet simultanee. Ad esempio, questo problema può verificarsi durante l'avvio del sistema quando si tentano contemporaneamente MB e altre connessioni e il servizio Network List Manager sta ancora tentando di determinare la connettività Internet di altre connessioni usando metodi attivi e passivi. Può verificarsi anche a causa di interruzioni temporanee nell'infrastruttura di rete, ad esempio un server proxy aziendale o una rete ISP. Pertanto, il servizio MB può tentare di connettersi automaticamente a Internet indipendentemente dal fatto che sia selezionata l'opzione "Connessione automatica solo se non è disponibile alcuna connessione Internet alternativa".

Requisiti

Vedi anche

Gestione del contesto dei pacchetti WWAN