IOCTL_NFCSE_SET_ROUTING_TABLE IOCTL (nfcsedev.h)
Mengonfigurasi tabel perutean mode mendengarkan pengontrol NFC. Perhatikan bahwa penelepon harus mengirim informasi perutean mode dengar lengkap dalam satu panggilan. Pemanggil harus memastikan bahwa tabel perutean kurang dari nilai cbMaxRoutingTableSize yang ditentukan dalam 4.2.5.1. Ukuran total dihitung sesuai standar NFC NCI detik 6.3.2 dan sama dengan Jumlah rute berbasis AID x 4 + jumlah cbAid + Jumlah rute berbasis teknologi x 5 + Jumlah rute berbasis protokol x 5. Pemanggil harus memastikan bahwa nilai untuk rute berbasis teknologi dan protokol sesuai dengan NCI NFC spec sec 6.3.2.
Kode utama
Buffer input
SECURE_ELEMENT_ROUTING_TABLE berisi semua entri perutean yang saat ini dikonfigurasi.
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_BUFFER_SIZE | Buffer yang disediakan lebih besar dari MAX_ROUTING_TABLE_SIZE pengontrol NFC. |
STATUS_FEATURE_NOT_SUPPORTED | NFCC tidak mendukung konfigurasi perutean mode mendengarkan. |
STATUS_INVALID_PARAMETER | Status ini dikembalikan jika buffer output bukan nol, atau nilai yang digunakan untuk teknologi atau protokol sesuai dengan spesifikasi NFC NCI detik 6.3.2, atau jika AID duplikat digunakan, atau saat menggunakan mode perutean yang tidak didukung oleh kemampuan pengontrol NFC saat ini. |
STATUS_INVALID_DEVICE_STATE | Kode ini dikembalikan jika IOCTL dikirim pada handel selain dengan nama relatif 'SEManage'. |
Keterangan
Berikut ini adalah persyaratan yang harus dipatuhi pengemudi.
- IOCTL ini dikirim pada handel dengan nama file relatif 'SEManage', jika tidak, driver HARUS menyelesaikannya dengan STATUS_INVALID_DEVICE_STATE.
- Driver harus memiliki entri tabel perutean mode dengar default awal yang merutekan teknologi RF protokol A, B, dan F dan/atau ISO-DEP yang dirutekan ke UICC SE jika ada. Entri perutean ini nantinya dapat ditimpa oleh konfigurasi tabel perutean mode dengar baru yang dimulai oleh host perangkat.
- Driver harus memastikan bahwa protokol NFC-DEP dipetakan ke host perangkat setiap saat. Bahkan jika penelepon tidak menentukan ini, driver perlu menambahkan aturan ini secara implisit.
- Jika IOCTL ini dikeluarkan ketika NFCC berada dalam status penemuan RF, driver perlu menempatkan NFCC ke dalam status menganggur RF, mengonfigurasi tabel perutean, dan memulai ulang penemuan RF.
Persyaratan
Persyaratan | Nilai |
---|---|
Header | nfcsedev.h |