IOCTL_NFP_DISABLE IOCTL (nfpdev.h)

  • Artikel

Klien mengirim permintaan IOCTL_NFP_DISABLE untuk menonaktifkan langganan, publikasi, dan peristiwa kehadiran untuk sementara waktu. Ini berguna ketika klien ingin menonaktifkan fungsionalitas kedekatan tetapi menjaga sumber daya yang dialokasikan untuk mengaktifkannya kembali dengan cepat saat diperlukan lagi.

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.

Jika tidak, Status ke kondisi kesalahan yang sesuai sebagai kode NTSTATUS.

Untuk informasi selengkapnya, lihat Nilai NTSTATUS.

Keterangan

Berikut ini adalah tindakan yang diperlukan saat menggunakan IOCTL ini:

  • Ketika IOCTL ini diterima, driver HARUS menandai handel file sebagai "Dinonaktifkan".
  • Jika handel langganan diubah menjadi "Dinonaktifkan, penyedia HARUS menghapus semua pesan dari antrean "Diterima" handel file tersebut.
  • Jika handel langganan "Dinonaktifkan":
    • Driver HARUS menyimpan antrean "Diterima" handel pada panjang nol dengan membersihkan (menghilangkan) pesan yang ada dalam antrean dan dengan menghilangkan pesan baru dari antrean segera setelah diterima.
    • Driver HARUS menyelesaikan semua permintaan IOCTL_NFP_GET_NEXT_SUBSCRIBED_MESSAGE yang tertunda pada handel tersebut dengan STATUS_CANCELLED.
  • Jika handel publikasi "Dinonaktifkan", penyedia TIDAK BOLEH mengirimkan pesan publikasi dan harus menyelesaikan semua permintaan IOCTL_NFP_GET_NEXT_TRANSMITTED_MESSAGE yang tertunda pada handel tersebut dengan STATUS_CANCELLED

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows 8
Header nfpdev.h

Lihat juga

IOCTL_NFP_ENABLE

Panduan desain keseluruhan komunikasi bidang dekat (NFC)

Panduan desain kedekatan bidang dekat (Ketuk dan Lakukan, model penyedia NFP, persyaratan driver)