IOCTL_SMARTCARD_IS_PRESENT IOCTL (winsmcrd.h)

Kode kontrol IOCTL_SMARTCARD_IS_PRESENT mendeteksi apakah kartu pintar saat ini terdeteksi. Jika kartu ada, kartu akan segera kembali dengan STATUS_SUCCESS. Jika tidak ada kartu pintar yang terdeteksi, kartu pintar berlangganan acara kedatangan kartu pintar dan terus tertunda. Menutup handel file akan berhenti berlangganan peristiwa.

Kode utama

IRP_MJ_DEVICE_CONTROL

Buffer input

Tidak ada.

Buffer output

Tidak ada.

Blok status

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

Kode Pengembalian Deskripsi
STATUS_PENDING Kode ini dikembalikan jika operasi sedang menunggu kartu pintar mendekati ke bidang radio.
STATUS_DEVICE_BUSY Kode ini dikembalikan jika operasi sudah menunggu peristiwa saat ini.
STATUS_INVALID_DEVICE_STATE Kode ini dikembalikan jika perangkat tidak dapat menerima permintaan.
STATUS_INVALID_PARAMETER Kode ini dikembalikan ketika buffer input atau output tidak valid.
STATUS_DEVICE_POWERED_OFF Kode ini dikembalikan ketika kontrol radio kedekatan nonaktif.

Keterangan

Tindakan berikut diperlukan saat menggunakan IOCTL ini:

  • Driver harus mendukung CancelIo pada IOCTL yang tertunda ini.

  • Ini adalah permintaan yang dikelola daya. IOCTL yang tertunda akan menjaga driver dalam status daya D0.
  • Driver harus mengembalikan STATUS_SUCCESS hanya untuk jenis yang didukung.

Persyaratan

Persyaratan Nilai
Header winsmcrd.h

Lihat juga

Panduan desain komunikasi bidang dekat (NFC)

Panduan desain kartu pintar