Bagikan melalui

IOCTL_NFP_GET_NEXT_TRANSMITTED_MESSAGE IOCTL (nfpdev.h)

  • Artikel

Klien yang tertarik untuk menerima pemberitahuan bahwa pesan telah dikirimkan akan mengirim permintaan IOCTL_NFP_GET_NEXT_TRANSMITTED_MESSAGE ke driver kedekatan.

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

  • Aplikasi klien akan mengirim IOCTL ini dalam perulangan kontrol ke handel publikasi. Dua transmisi terpisah dari pesan yang sama akan mengakibatkan pemicu dua peristiwa.
  • Klien harus mengirim IOCTL lain setiap kali IOCTL yang tertunda selesai. Driver HARUS menggunakan kunci yang sesuai untuk menjamin bahwa jumlah keberhasilan penyelesaian IOCTL ini sama dengan berapa kali publikasi telah ditransmisikan.
  • Tindakan berikut diperlukan saat menggunakan IOCTL ini:
    • Jika IOCTL ini diterima pada handel yang sebelumnya belum berhasil IOCTL_NFP_SET_PAYLOAD, driver HARUS menyelesaikannya dengan STATUS_INVALID_DEVICE_STATE.
    • Driver harus mempertahankan penghitung "CompleteEventImmediately" yang setara (ULONG atau lebih besar) dalam handel file publikasi.
    • Ketika IOCTL ini diterima di driver:
      • Jika penghitung adalah nol, maka driver HARUS menunggu IOCTL untuk penyelesaian nanti.
      • Jika penghitung lebih besar dari nol, maka driver HARUS menurunkan penghitung satu per satu dan menyelesaikan IOCTL dengan STATUS_SUCCESS segera.
    • Jika publikasi ditransmisikan dan tidak ada IOCTL yang saat ini tertunda, driver HARUS menaikkan penghitung "CompleteEventImmediately" satu per satu.
    • Jika publikasi ditransmisikan saat ada IOCTL tertunda yang tersedia, driver HARUS menyelesaikan IRP yang tertunda dengan STATUS_SUCCESS dan TIDAK menaikkan penghitung "CompleteEventImmediately".
    • Jika IOCTL berisi buffer input atau output, driver HARUS menyelesaikan IOCTL dengan STATUS_INVALID_PARAMETER.
    • Jika IOCTL ini diterima sementara yang lain saat ini tertunda dalam handel publikasi, yang kedua (atau yang lebih baru) HARUS diselesaikan dengan STATUS_INVALID_DEVICE_STATE.
    • Driver HARUS mendukung CancelIo dari IOCTL yang tertunda.

Persyaratan

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

Lihat juga

Panduan desain keseluruhan near field communication (NFC)

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