IOCTL_NFCSE_SET_ROUTING_TABLE IOCTL (nfcsedev.h)

  • Artikel

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

IRP_MJ_DEVICE_CONTROL

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