IOCTL_NFCSE_SET_CARD_EMULATION_MODE IOCTL (nfcsedev.h)
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
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 |
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk