IOCTL_NFCSE_SET_CARD_EMULATION_MODE IOCTL (nfcsedev.h)

  • Artikel

Kode kontrol IOCTL_NFCSE_SET_CARD_EMULATION_MODE mengatur apakah elemen aman yang ditentukan diekspos dalam mode emulasi kartu. Ketika elemen aman "diekspos" sebagai emulasi kartu, itu berarti ketika perangkat dibawa ke pembaca eksternal bahwa elemen aman dapat diakses oleh pembaca. IOCTL dikeluarkan pada handel file yang dibuka dengan nama file relatif 'SEManage'. Driver HARUS memberikan akses eksklusif ke klien untuk mengelola mode emulasi kartu, yaitu, panggilan berikutnya untuk membuka handel file menggunakan nama file relatif 'SEManage' akan gagal dengan STATUS_ACCESS_DENIED sampai klien dengan akses eksklusif menutup handel filenya.

Kode utama

IRP_MJ_DEVICE_CONTROL

Buffer input

SECURE_ELEMENT_SET_CARD_EMULATION_MODE_INFO struktur.

Buffer output

Tidak ada

Blok status

Irp->IoStatus.Status diatur ke STATUS_SUCCESS jika permintaan berhasil. Kemungkinan kode kesalahan adalah:

Kode Pengembalian Deskripsi
STATUS_INVALID_PARAMETER Jika GUID elemen aman tidak valid atau buffer output bukan nol.
STATUS_INVALID_DEVICE_STATE Jika IOCTL dikirim pada handel selain dengan nama relatif 'SEManage'.

Keterangan

Berikut ini adalah persyaratan yang harus dipatuhi pengemudi.

  • IOCTL ini harus dipanggil pada handel yang memiliki nama file relatif SEEvents; jika tidak, driver mengembalikan STATUS_INVALID_DEVICE_STATE.
  • Jika mode emulasi kartu diatur ke EmulationOff untuk semua elemen aman yang melekat pada pengontrol NFC, mode emulasi perulangan polling harus dinonaktifkan. Jika fitur kedekatan juga dinonaktifkan, driver harus beralih ke mode daya rendah.
  • Jika mode emulasi kartu diatur ke nilai selain EmulationOff, maka driver harus terus berada dalam status D0 dan mode emulasi perulangan polling harus diaktifkan (dapat dideteksi oleh pembaca eksternal).
  • Ketika handel file yang dibuka SEManage ditutup, driver harus mengatur pengaturan mode emulasi kartu dari semua elemen aman menjadi EmulationOff kecuali ketika status mode emulasi kartu yang terakhir diatur adalah EmulationOnPowerIndependent. Jika status mode emulasi kartu set terakhir adalah EmulationOnPowerIndependent, driver harus tetap dengan pengaturan mode emulasi kartu ke Aktif dengan opsi PbF untuk elemen aman tertentu.
  • Driver harus memberikan akses eksklusif ke klien untuk mengelola mode emulasi kartu. Panggilan berikutnya untuk membuka handel file menggunakan nama file relatif SEManage akan gagal dengan STATUS_ACCESS_DENIED sampai klien dengan akses eksklusif menutup handel filenya.

Persyaratan

Persyaratan Nilai
Header nfcsedev.h