WWAN_SET_CONTEXT_STATE struttura (wwan.h)
La struttura WWAN_SET_CONTEXT_STATE rappresenta il comando per impostare lo stato del contesto PDP (Packet Data Protocol) del dispositivo MB.
Sintassi
typedef struct _WWAN_SET_CONTEXT_STATE {
ULONG ConnectionId;
WWAN_ACTIVATION_COMMAND ActivationCommand;
WCHAR AccessString[WWAN_ACCESSSTRING_LEN];
WCHAR UserName[WWAN_USERNAME_LEN];
WCHAR Password[WWAN_PASSWORD_LEN];
WWAN_COMPRESSION Compression;
WWAN_AUTH_PROTOCOL AuthType;
WWAN_IP_TYPE IPType;
WWAN_PSMEDIA_PREFERENCE MediaPreference;
WWAN_CONFIGURATION_SOURCE ConnectionMediaSource;
WWAN_ACTIVATION_OPTION ActivationOption;
WWAN_SINGLE_NSSAI Snssai;
WWAN_OFFSET_SIZE_ELEMENT TrafficParameters;
} WWAN_SET_CONTEXT_STATE, *PWWAN_SET_CONTEXT_STATE;
Members
ConnectionId
Il servizio MB specifica questo membro per identificare in modo univoco il contesto PDP e il relativo stato corrispondente.
Il servizio MB usa il valore in questo membro per identificare in modo univoco il contesto attivo corrente tra schede di rete MB.
Il driver miniport deve usare il valore in questo membro quando si completano le richieste impostate . Il servizio MB usa il valore in questo membro nelle richieste di query successive e disconnette le richieste al driver miniport.
ActivationCommand
Attivare o disattivare un contesto PDP a cui si fa riferimento nel membro ConnectionId . La tabella seguente mostra i valori possibili che un driver miniport può specificare.
| Valore | Significato |
|---|---|
| WwanActivationCommandActivate | Attivare il contesto PDP a cui fa riferimento ConnectionId . |
| WwanActivationCommandDeactivate | Disattivare un contesto PDP attualmente attivato a cui fa riferimento ConnectionId . |
AccessString[WWAN_ACCESSSTRING_LEN]
Stringa con terminazione NULL per accedere alla rete. Per le reti basate su GSM, si tratta di una stringa APN (Access Point Name), ad esempio "data.thephone-company.com". Per le reti basate su CDMA, questo potrebbe essere un codice di composizione speciale, ad esempio "#777" o un identificatore di accesso di rete (NAI), ad esempio "foo@thephone-company.com". Questo membro può essere NULL.
Le dimensioni della stringa non devono superare 100 byte.
UserName[WWAN_USERNAME_LEN]
Stringa con terminazione NULL che rappresenta il nome utente da autenticare. Questo membro può essere NULL.
Password[WWAN_PASSWORD_LEN]
Stringa con terminazione NULL che rappresenta la password del nome utente. Questo membro può essere NULL.
Compression
Valore dell'enumerazione WWAN_COMPRESSION che specifica se la compressione deve essere usata nella connessione dati per intestazione e dati. Questo membro si applica solo ai dispositivi basati su GSM. Il servizio MB imposta questo membro su WwanCompressionNone per i dispositivi basati su CDMA.
| Valore | Significato |
|---|---|
| WwanCompressionNone | Non viene applicata alcuna compressione. |
| WwanCompressionEnable | Abilitare l'intestazione e la compressione dei dati. |
AuthType
Valore dell'enumerazione WWAN_AUTH_PROTOCOL che specifica il tipo di autenticazione da usare per l'attivazione PDP. Questo membro si applica solo ai dispositivi basati su GSM. Il servizio MB imposta questo membro su WwanAuthProtocolNone per i dispositivi basati su CDMA.
| Valore | Significato |
|---|---|
| WwanAuthProtocolNone | Nessun protocollo di autenticazione. |
| WwanAuthProtocolPap | Autenticazione password non crittografata. |
| WwanAuthProtocolChap | Usare il protocollo di autenticazione handshake challenge (CHAP). |
| WwanAuthProtocolMsChapV2 | Usare Microsoft Challenge Handshake Authentication Protocol (CHAP) v2.0. |
IPType
Valore dell'enumerazione WWAN_IP_TYPE che specifica il tipo di IP.
MediaPreference
ConnectionMediaSource
ActivationOption
Valore dell'enumerazione WWAN_ACTIVATION_OPTION che rappresenta le opzioni di attivazione PDP (Packet Data Protocol) supportate dal dispositivo MB.
Snssai
Struttura WWAN_SINGLE_NSSAI che rappresenta un'unica informazione di assistenza per la selezione di sezioni di rete (NSSAI).
TrafficParameters
Struttura WWAN_OFFSET_SIZE_ELEMENT . I primi 4 byte sono l'offset di DataBuffer contenente i dati non elaborati del campo dati MBIM_TLV_TYPE_TRAFFIC_PARAMETERS, in byte, calcolati dall'inizio di WWAN_SET_CONTEXT_STATE. I secondi 4 byte sono dimensioni dei dati non elaborati di MBIM_TLV_TYPE_TRAFFIC_PARAMETERS campo dati, in byte.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Disponibile in Windows 8 e versioni successive di Windows. |
| Intestazione | wwan.h (include Wwan.h) |