IOCTL_NFCRM_SET_RADIO_STATE IOCTL (nfcradiodev.h)

  • Artikel

IOCTL ini digunakan oleh aplikasi atau layanan manajemen radio untuk mengatur status daya radio perangkat kedekatan. Bidang MediaRadioOn digunakan untuk menunjukkan status daya permintaan. Ketika status daya radio kedekatan dinonaktifkan, driver harus menonaktifkan antarmuka perangkat kedekatan (antarmuka GUID_DEVINTERFACE_NFP dan GUID_DEVINTERFACE_SMARTCARD_READER) dan menonaktifkan mode P2P dan pembaca/penulis perangkat. Jika status daya radio kedekatan diaktifkan, driver harus mengaktifkan antarmuka perangkat kedekatan dan mengaktifkan mode P2P dan pembaca/penulis pengontrol. Untuk informasi selengkapnya tentang mengoptimalkan mode daya pada perangkat ini, lihat NFC Power Management.

Kode utama

IRP_MJ_DEVICE_CONTROL

Buffer input

struktur NFCRM_SET_RADIO_STATE

Panjang buffer input

sizeof(NFCRM_SET_RADIO_STATE)

Buffer output

Tidak ada

Panjang 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_INVALID_DEVICE_STATE Kode ini dikembalikan ketika perangkat sudah dalam status daya radio kedekatan yang sedang diatur oleh klien.

Keterangan

Kode pengembalian STATUS_INVALID_PARAMETER tidak lagi diperlukan. Bug ditemukan di Windows 10 build 10240, bahwa Windows akan mengirim parameter output non-null dengan IOCTL ini. Bug ini diperbaiki di versi Windows yang lebih baru. Untuk menyederhanakan kode, driver dapat mengabaikan parameter output di semua versi Windows 10.

Persyaratan

Persyaratan Nilai
Header nfcradiodev.h