NDIS_STATUS_WWAN_PIN_INFO

  • Artikel

Driver Miniport menggunakan pemberitahuan NDIS_STATUS_WWAN_PIN_INFO untuk merespons kueri OID dan mengatur permintaan OID_WWAN_PIN.

Driver miniport tidak dapat menggunakan pemberitahuan ini untuk mengirim kejadian yang tidak diminta.

Pemberitahuan ini menggunakan struktur NDIS_WWAN_PIN_INFO .

Keterangan

Driver miniport harus mengembalikan informasi tentang Nomor Identitas Pribadi (PIN) yang saat ini diharapkan perangkat MB sebagai respons terhadap permintaan kueri. Driver miniport harus mengembalikan pemberitahuan status yang diisi seperti yang dijelaskan di bagian di bawah ini sebagai respons terhadap permintaan yang ditetapkan.

Menanggapi Permintaan WwanPinOperationEnter

Ketika driver miniport menggunakan pemberitahuan NDIS_STATUS_WWAN_PIN_INFO untuk menanggapi permintaan WwanPinOperationEnter , mereka harus menerapkan prosedur ini:

  • Untuk permintaan kueri WwanPinOperationEnter yang berhasil, ketika perangkat MB tidak lagi memerlukan PIN, driver miniport harus mengatur uStatus ke WWAN_STATUS_SUCCESS dan PinType ke WwanPinTypeNone.

  • Untuk permintaan WwanPinOperationEnter yang gagal, driver miniport harus mengatur uStatus ke WWAN_STATUS_FAILURE dan menyertakan data yang berlaku sesuai detail berikut:

    • PIN Dinonaktifkan atau PIN Tidak Diharapkan: Untuk permintaan set WwanPinOperationEnter , ketika PIN yang sesuai dinonaktifkan atau saat ini tidak diharapkan oleh perangkat MB, driver miniport harus mengatur PinType ke WwanPinTypeNone. Semua anggota lain diabaikan.

    • PIN Tidak Didukung: Jika PIN yang diberikan tidak didukung oleh perangkat MB, driver miniport harus mengatur uStatus ke WWAN_STATUS_NO_DEVICE_SUPPORT.

    • Pengambilan PIN: Dalam mode ini, perangkat MB mengharuskan PIN dimasukkan kembali karena nilai AttemptsRemaining masih bukan nol untuk jenis PIN tertentu ini. Driver miniport harus mengatur PinType ke nilai yang sama dengan PinType di NDIS_WWAN_SET_PIN.

    • Pemblokiran PIN: PIN diblokir ketika AttemptsRemaining adalah nol. Jika operasi pemblokiran PIN tidak tersedia, driver miniport harus mengatur uStatus ke WWAN_STATUS_FAILURE dan PinType ke WwanPinTypeNone. Semua anggota lain diabaikan.

      Catatan Jika perangkat MB mendukung operasi buka blokir PIN, driver miniport harus mengikuti langkah Pemblokiran PIN untuk menanggapi permintaan.

    • Pemblokiran PIN: PIN diblokir saat AttemptsRemaining adalah nol. Untuk membuka blokir PIN, perangkat MB dapat meminta PIN Unlock Key (PUK) yang sesuai, jika berlaku. Dalam hal ini, driver miniport harus mengatur PinType ke WwanPinTypeXxxPUK yang sesuai dengan detail yang relevan.

    • PUK yang diblokir: Jika jumlah uji coba yang gagal melebihi nilai preset untuk memasukkan WwanPinTypeXxxPUK, maka PUK akan diblokir. Driver miniport harus memberi sinyal ini dengan mengatur uStatus ke WWAN_STATUS_FAILURE dan PinType ke WwanPinTypeNone. Jika PUK1 diblokir, driver miniport harus mengirim NDIS_STATUS_WWAN_READY_INFO dengan ReadyState diatur ke WwanReadyStateBadSim.

Menanggapi Permintaan WwanPinOperationEnable, WwanPinOperationDisable, atau WwanPinOperationChange

Ketika driver miniport menggunakan pemberitahuan NDIS_STATUS_WWAN_PIN_INFO untuk merespons WwanPinOperationEnable, WwanPinOperationDisable, dan WwanPinOperationChange, mereka harus menerapkan operasi berikut:

  • Agar permintaan berhasil, driver miniport harus mengatur uStatus ke WWAN_STATUS_SUCCESS. Untuk anggota lain dalam WWAN_PIN_INFO, lihat keadaan berikut.

  • Driver Miniport harus mengatur uStatus ke WWAN_STATUS_SUCCESS untuk operasi pin-enable dan PIN-disable ketika PIN sudah dalam status yang diminta. Driver miniport harus mengatur PinType ke WwanPinTypeNone. Anggota lain diabaikan.

  • Ketika mode PIN diubah dari dinonaktifkan menjadi diaktifkan, status PIN harus WwanPinStateNone.

  • Jika PIN1 diaktifkan, status PIN akan menjadi WwanPinStateEnter ketika daya disederhanakan ke perangkat MB.

  • Untuk semua PIN lainnya, status PIN dapat berubah dari WwanPinStateNone ke WwanPinStateEnter tergantung pada kondisi spesifik perangkat MB.

  • PIN Tidak Didukung: Jika operasi PIN tidak didukung oleh perangkat MB, driver miniport harus mengatur uStatus ke WWAN_STATUS_NO_DEVICE_SUPPORT. Misalnya, mengaktifkan dan menonaktifkan PIN2 biasanya tidak didukung oleh perangkat MB sehingga kode kesalahan di atas harus dikembalikan. Semua anggota lain diabaikan.

  • PIN Harus Dimasukkan: Jika operasi PIN mengharuskan PIN dimasukkan, driver miniport harus mengatur uStatus ke WWAN_STATUS_PIN_REQUIRED dan PinType ke WwanPinTypeXxx. Anggota lain diabaikan.

  • Operasi Perubahan PIN: Jika perangkat MB membatasi perubahan nilai PIN hanya saat dalam status diaktifkan, permintaan untuk mengubah status dinonaktifkan harus dikembalikan dengan WWAN_STATUS_PIN_DISABLED.

  • Pengambilan PIN: Jika gagal, driver miniport harus mengatur uStatus ke WWAN_STATUS_FAILURE, dan PinType ke nilai yang sama seperti yang ditentukan dalam NDIS_WWAN_SET_PIN. Anggota lain diabaikan kecuali untuk AttemptsRemaining. Ini dapat terjadi ketika PIN yang salah dimasukkan.

  • Pemblokiran PIN: PIN diblokir ketika jumlah AttemptsRemaining adalah nol. Jika operasi pemblokiran PIN tidak tersedia, driver miniport harus mengatur uStatus ke WWAN_STATUS_FAILURE dan PinType ke WwanPinTypeNone. AttemptsRemaining harus diatur ke 0 dan semua anggota lainnya diabaikan.

    Catatan Jika perangkat MB mendukung operasi buka blokir PIN, driver miniport harus mengikuti langkah Pemblokiran PIN untuk menanggapi permintaan.

  • Membuka blokir PIN: PIN diblokir saat AttemptsRemaining adalah nol. Untuk membuka blokir PIN, perangkat MB dapat meminta PUK yang sesuai, jika berlaku. Dalam hal ini, driver miniport harus mengatur uStatus ke WWAN_STATUS_FAILURE, PinType ke WwanPinTypeXxxPUK yang sesuai, PinState ke WwanPinStateEnter, dan AttemptsRemaining harus memiliki jumlah upaya yang diizinkan untuk memasukkan PUK yang valid.

    Jika pemblokiran PIN menghasilkan perangkat MB atau SIM menjadi diblokir, driver miniport harus mengirim pemberitahuan peristiwa dengan ReadyState yang diatur ke WwanReadyStateDeviceLocked.

  • Jika ada konteks PDP aktif pada saat pemblokiran PIN1, driver miniport harus menonaktifkan konteks PDP dan mengirim pemberitahuan ke sistem operasi tentang penonaktifan PDP dan perubahan status tautan.

Persyaratan

Versi

Tersedia di Windows 7 dan versi Windows yang lebih baru.

Header

 Ndis.h

Lihat juga

OID_WWAN_PIN

NDIS_STATUS_WWAN_PIN_INFO