struktur WWAN_SET_CONTEXT_STATE (wwan.h)

Struktur WWAN_SET_CONTEXT_STATE mewakili perintah untuk mengatur status konteks Packet Data Protocol (PDP) perangkat MB.

Sintaks

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;

Anggota

ConnectionId

Layanan MB menentukan anggota ini untuk mengidentifikasi Konteks PDP secara unik dan status yang sesuai.

Layanan MB menggunakan nilai dalam anggota ini untuk mengidentifikasi konteks aktif saat ini secara unik di seluruh adaptor jaringan MB.

Driver miniport harus menggunakan nilai dalam anggota ini saat menyelesaikan permintaan yang ditetapkan . Layanan MB menggunakan nilai dalam anggota ini dalam permintaan kueri berikutnya serta memutuskan permintaan ke driver miniport.

ActivationCommand

Mengaktifkan atau menonaktifkan konteks PDP yang dirujuk dalam anggota ConnectionId . Tabel berikut ini memperlihatkan nilai yang mungkin dapat ditentukan driver miniport.

Nilai	Makna
WwanActivationCommandActivate	Aktifkan konteks PDP yang dirujuk oleh ConnectionId .
WwanActivationCommandDeactivate	Nonaktifkan konteks PDP yang saat ini diaktifkan yang dirujuk oleh ConnectionId .

AccessString[WWAN_ACCESSSTRING_LEN]

String yang dihentikan NULL untuk mengakses jaringan. Untuk jaringan berbasis GSM, ini akan menjadi string Nama Titik Akses (APN) seperti "data.thephone-company.com". Untuk jaringan berbasis CDMA, ini mungkin merupakan kode putar nomor khusus seperti "#777" atau Pengidentifikasi Akses Jaringan (NAI) seperti "foo@thephone-company.com". Anggota ini bisa NULL.

Ukuran string tidak boleh melebihi 100 byte.

UserName[WWAN_USERNAME_LEN]

String yang dihentikan NULL yang mewakili nama pengguna untuk mengautentikasi. Anggota ini bisa NULL.

Password[WWAN_PASSWORD_LEN]

String yang dihentikan NULL yang mewakili kata sandi nama pengguna. Anggota ini bisa NULL.

Compression

Nilai dari enumerasi WWAN_COMPRESSION yang menentukan apakah pemadatan harus digunakan dalam koneksi data untuk header dan data. Anggota ini hanya berlaku untuk perangkat berbasis GSM. Layanan MB menetapkan anggota ini ke WwanCompressionNone untuk perangkat berbasis CDMA.

Nilai	Makna
WwanCompressionNone	Tidak ada pemadatan yang diterapkan.
WwanCompressionEnable	Aktifkan kompresi header dan data.

AuthType

Nilai dari enumerasi WWAN_AUTH_PROTOCOL yang menentukan jenis autentikasi yang akan digunakan untuk aktivasi PDP. Anggota ini hanya berlaku untuk perangkat berbasis GSM. Layanan MB menetapkan anggota ini ke WwanAuthProtocolNone untuk perangkat berbasis CDMA.

Nilai	Makna
WwanAuthProtocolNone	Tidak ada protokol autentikasi.
WwanAuthProtocolPap	Autentikasi kata sandi tidak terenkripsi.
WwanAuthProtocolChap	Gunakan Challenge Handshake Authentication Protocol (CHAP).
WwanAuthProtocolMsChapV2	Gunakan Microsoft Challenge Handshake Authentication Protocol (CHAP) v2.0.

IPType

Nilai dari enumerasi WWAN_IP_TYPE yang menentukan jenis IP.

MediaPreference

ConnectionMediaSource

ActivationOption

Nilai dari enumerasi WWAN_ACTIVATION_OPTION yang mewakili opsi aktivasi Packet Data Protocol (PDP) yang didukung perangkat MB.

Snssai

Struktur WWAN_SINGLE_NSSAI yang mewakili satu Informasi Bantuan Pemilihan Ilis Jaringan (NSSAI).

TrafficParameters

Struktur WWAN_OFFSET_SIZE_ELEMENT . 4 byte pertama adalah offset ke DataBuffer yang berisi data mentah bidang data MBIM_TLV_TYPE_TRAFFIC_PARAMETERS, dalam byte, dihitung dari awal WWAN_SET_CONTEXT_STATE. 4 byte kedua adalah ukuran data mentah bidang data MBIM_TLV_TYPE_TRAFFIC_PARAMETERS, dalam byte.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Tersedia di Windows versi Windows 8 dan yang lebih baru.
Header	wwan.h (termasuk Wwan.h)

Lihat juga

NDIS_WWAN_SET_CONTEXT_STATE

WWAN_ACTIVATION_COMMAND

WWAN_AUTH_PROTOCOL

WWAN_COMPRESSION