IOCTL_NFCSE_ENUM_ENDPOINTS IOCTL (nfcsedev.h)

  • Artikel

Mengembalikan informasi mengenai daftar semua elemen aman yang dilampirkan ke pengontrol NFC. Perhatikan bahwa pemanggil harus mengalokasikan buffer output yang cukup besar untuk menyimpan informasi mengenai semua elemen aman yang dihitung oleh driver yaitu Jumlah total SES Enumerasi x Ukuran info titik akhir SE jika tidak, driver harus mengembalikan kode kesalahan STATUS_BUFFER_OVERFLOW ke klien dengan bidang NumberOfEndpoints yang berisi jumlah elemen aman yang dijumlahkan. GUID mengidentifikasi elemen aman yang mungkin digunakan untuk merujuk ke elemen aman tertentu.

Kode utama

IRP_MJ_DEVICE_CONTROL

Buffer input

Tidak ada

Panjang buffer input

Tidak ada

Buffer output

SECURE_ELEMENT_ENDPOINT_LIST untuk setiap perangkat yang dijumlahkan.

Blok status

Irp->IoStatus.Status diatur ke STATUS_SUCCESS jika permintaan berhasil. Kode kesalahan yang mungkin adalah:

Kode Pengembalian Deskripsi
STATUS_INVALID_PARAMETER Kode ini dikembalikan ketika buffer output bukan nol.
STATUS_BUFFER_OVERFLOW Buffer yang disediakan terlalu kecil untuk menerima konfigurasi tabel perutean.

Keterangan

Berikut ini adalah persyaratan yang harus dipatuhi pengemudi.

  • Dalam kasus elemen aman terintegrasi, GUID adalah pengidentifikasi unik yang berasal dari nomor seri dan/atau identifikasi unik lainnya dari elemen aman.
  • Untuk elemen aman eksternal, GUID mungkin konstanta tetap dan hanya mengidentifikasi "soket" tempat elemen aman terhubung.
  • Untuk elemen aman host perangkat, driver akan menghitungnya sebagai titik akhir SE hanya jika mendukung Emulasi Kartu Host. GUID yang digunakan untuk DH mungkin konstanta tetap yang ditentukan oleh driver.
  • Pemanggil diperlukan untuk mengalokasikan buffer output yang cukup besar untuk menyimpan informasi tentang semua elemen aman yang dijumlahkan oleh driver. Buffer harus sama dengan jumlah total SEs yang dihitung oleh driver dikalikan dengan ukuran informasi titik akhir SE. Jika buffer yang sesuai tidak dialokasikan, driver mengembalikan kode kesalahan STATUS_BUFFER_OVERFLOW ke klien dengan bidang NumberOfEndpoints yang berisi jumlah elemen aman yang dijumlahkan.

Persyaratan

Persyaratan Nilai
Header nfcsedev.h