Komunikasi bidang dekat (NFC)

Gambaran umum teknologi Near field communications (NFC).

Untuk mengembangkan Komunikasi bidang dekat (NFC), Anda memerlukan header ini:

• nfccx.h
• nfcradiodev.h
• nfcsedev.h
• nfpdev.h
• winsmcrd.h

Untuk panduan pemrograman, lihat Komunikasi bidang dekat (NFC).

IOCTL

IOCTL_NFCRM_QUERY_RADIO_STATE IOCTL ini digunakan oleh aplikasi atau layanan manajemen radio untuk mengkueri status daya radio perangkat kedekatan saat ini.
IOCTL_NFCRM_SET_RADIO_STATE IOCTL ini digunakan oleh aplikasi atau layanan manajemen radio untuk mengatur status daya radio perangkat kedekatan.
IOCTL_NFCSE_ENUM_ENDPOINTS Mengembalikan informasi mengenai daftar semua elemen aman yang dilampirkan ke pengontrol NFC.
IOCTL_NFCSE_GET_NEXT_EVENT Kode kontrol IOCTL_NFCSE_GET_NEXT_EVENT mengembalikan peristiwa berikutnya yang tersedia di buffer, atau jika tidak ada lagi peristiwa buffer yang tetap tertunda hingga peristiwa elemen aman tersedia. Detail peristiwa kemudian harus dikembalikan ke pemanggil.
IOCTL_NFCSE_GET_NFCC_CAPABILITIES Kode kontrol IOCTL_NFCSE_GET_NFCC_CAPABILITIES mengembalikan informasi tentang kemampuan pengontrol NFC saat ini, termasuk ukuran tabel Perutean Mode Dengar maksimum (ditentukan dalam bagian 4.2 dari Spesifikasi Teknis Antarmuka Pengontrol NFC (NCI) Versi 1.1) dan mode perutean yang didukung.
IOCTL_NFCSE_GET_ROUTING_TABLE Mengembalikan informasi mengenai konfigurasi tabel perutean mode mendengarkan saat ini.
IOCTL_NFCSE_HCE_REMOTE_RECV Mengembalikan buffer data berikutnya yang tersedia, atau jika tidak ada lagi data yang di-buffer, permintaan akan tetap tertunda hingga buffer APDU tersedia untuk dibaca.
IOCTL_NFCSE_HCE_REMOTE_SEND Mengirimkan RESPONS APDU dari DeviceHost NFCEE ke perangkat jarak jauh. Pemanggil harus yakin bahwa APDU respons sesuai dengan ISO-IEC 7816-4.
IOCTL_NFCSE_SET_CARD_EMULATION_MODE Kode kontrol IOCTL_NFCSE_SET_CARD_EMULATION_MODE mengatur apakah elemen aman yang ditentukan diekspos dalam mode emulasi kartu.
IOCTL_NFCSE_SET_ROUTING_TABLE Mengonfigurasi tabel perutean mode mendengarkan pengontrol NFC.
IOCTL_NFCSE_SUBSCRIBE_FOR_EVENT Kode kontrol IOCTL_NFCSE_SUBSCRIBE_FOR_EVENT dikeluarkan oleh klien untuk berlangganan peristiwa tertentu.
IOCTL_NFCSERM_QUERY_RADIO_STATE IOCTL_NFCSERM_QUERY_RADIO_STATE digunakan oleh aplikasi atau layanan manajemen radio SE untuk mengkueri status daya radio perangkat kedekatan saat ini.
IOCTL_NFCSERM_SET_RADIO_STATE IOCTL_NFCSERM_SET_RADIO_STATE digunakan oleh aplikasi atau layanan manajemen radio SE untuk mengatur status daya radio perangkat kedekatan saat ini.
IOCTL_NFP_DISABLE Klien mengirim permintaan IOCTL_NFP_DISABLE untuk menonaktifkan langganan, publikasi, dan peristiwa kehadiran untuk sementara waktu.
IOCTL_NFP_ENABLE Klien mengirim permintaan IOCTL_NFP_ENABLE untuk mengaktifkan kembali langganan, publikasi, dan peristiwa kehadiran yang dinonaktifkan sebelumnya.
IOCTL_NFP_GET_KILO_BYTES_PER_SECOND Klien mengirimkan permintaan IOCTL_NFP_GET_KILO_BYTES_PER_SECOND ke handel generik apa pun, yang tidak diterbitkan dan tidak berlangganan, ke perangkat penyedia.
IOCTL_NFP_GET_MAX_MESSAGE_BYTES Klien mengirim permintaan IOCTL_NFP_GET_MAX_MESSAGE_BYTES ke handel generik apa pun, yang tidak diterbitkan dan tidak berlangganan, ke perangkat penyedia untuk menentukan ukuran pesan maksimum yang didukung.
IOCTL_NFP_GET_NEXT_SUBSCRIBED_MESSAGE Klien mengirim permintaan IOCTL_NFP_GET_NEXT_SUBSCRIBED_MESSAGE ke handel langganan berulang kali untuk menerima pesan berlangganan saat mereka tiba.
IOCTL_NFP_GET_NEXT_TRANSMITTED_MESSAGE Klien yang tertarik untuk menerima pemberitahuan bahwa pesan telah dikirimkan akan mengirim permintaan IOCTL_NFP_GET_NEXT_TRANSMITTED_MESSAGE ke driver kedekatan.
IOCTL_NFP_SET_PAYLOAD Aplikasi klien mengirim data pesan dan mengonfirmasi publikasi dengan permintaan IOCTL_NFP_SET_PAYLOAD.
IOCTL_SMARTCARD_GET_ATTRIBUTE Kode kontrol IOCTL_SMARTCARD_GET_ATTRIBUTE kueri untuk atribusi kartu pintar.
IOCTL_SMARTCARD_GET_STATE Kode kontrol IOCTL_SMARTCARD_GET_STATE mendapatkan status kartu pintar saat ini.
IOCTL_SMARTCARD_IS_ABSENT Kode kontrol IOCTL_SMARTCARD_IS_ABSENT segera kembali dengan STATUS_SUCCESS jika tidak ada kartu pintar yang saat ini terdeteksi.
IOCTL_SMARTCARD_IS_PRESENT Kode kontrol IOCTL_SMARTCARD_IS_PRESENT mendeteksi apakah kartu pintar saat ini terdeteksi.
IOCTL_SMARTCARD_POWER Windows mungkin memerlukan pengandar agar IOCTL ini menjadi NOP dan mengembalikan keberhasilan.
IOCTL_SMARTCARD_SET_ATTRIBUTE Kode kontrol IOCTL_SMARTCARD_SET_ATTRIBUTE menetapkan atribut dan mengembalikan STATUS_SUCCESS pada SCARD_ATTR_DEVICE_IN_USE; jika tidak, ia mengembalikan STATUS_NOT_SUPPORTED.
IOCTL_SMARTCARD_SET_PROTOCOL Mengatur procotol yang dikomunikasikan driver ke kartu pintar setelah kartu terdeteksi.
IOCTL_SMARTCARD_TRANSMIT Mengirimkan data dari klien ke kartu pintar yang terdeteksi di APDU yang mematuhi ISO7816-4.

Enumerasi

NFC_CX_CE_MODE_CONFIG Enumerasi ini menentukan bendera mode mendengarkan CE.
NFC_CX_DEVICE_MODE Menentukan bendera mode perangkat.
NFC_CX_DRIVER_FLAGS Menentukan bendera driver run-time.
NFC_CX_HOST_ACTION Enumerasi NFC_CX_HOST_ACTION menentukan tindakan host.
NFC_CX_NFCIP_MODE_CONFIG Enumerasi NFC_CX_NFCIP_MODE_CONFIG menentukan mode inisiator NFC-IP.
NFC_CX_NFCIP_TGT_MODE_CONFIG Enumerasi NFC_CX_NFCIP_TGT_MODE_CONFIG menentukan mode target NFC-IP.
NFC_CX_POLL_BAILOUT_CONFIG Enumerasi NFC_CX_POLL_BAILOUT_CONFIG menentukan bail out mode polling.
NFC_CX_POLL_MODE_CONFIG Enumerasi NFC_CX_POLL_MODE_CONFIG menentukan mode polling.
NFC_CX_SEQUENCE Enumerasi NFC_CX_SEQUENCE menentukan urutan.
NFC_CX_TRANSPORT_TYPE Enumerasi NFC_CX_TRANSPORT_TYPE menentukan jenis transportasi.
SECURE_ELEMENT_CARD_EMULATION_MODE Enumerasi ini menunjukkan mode emulasi kartu dari elemen aman.
SECURE_ELEMENT_EVENT_TYPE Menunjukkan jenis peristiwa elemen aman.
SECURE_ELEMENT_ROUTING_TYPE SECURE_ELEMENT_ROUTING_TYPE adalah anggota SECURE_ELEMENT_ROUTING_TABLE_ENTRY.
SECURE_ELEMENT_TYPE Menunjukkan jenis elemen aman.

Fungsi

EVT_NFC_CX_DEVICE_IO_CONTROL Dipanggil oleh NFC CX untuk mengirim IOCTL yang tidak tertangani ke driver klien.
EVT_NFC_CX_SEQUENCE_HANDLER Dipanggil oleh NFC CX untuk memberi tahu driver klien untuk menangani urutan terdaftar tertentu.
EVT_NFC_CX_WRITE_NCI_PACKET Dipanggil oleh NFC CX untuk mengirim paket tulis ke driver klien.
NFC_CX_CLIENT_CONFIG_INIT Fungsi NFC_CX_CLIENT_CONFIG_INIT menginisialisasi struktur NFC_CX_CLIENT_CONFIG.
NFC_CX_LLCP_CONFIG_INIT Fungsi NFC_CX_LLCP_CONFIG_INIT menginisialisasi struktur NFC_CX_LLCP_CONFIG.
NFC_CX_RF_DISCOVERY_CONFIG_INIT Fungsi NFC_CX_RF_DISCOVERY_CONFIG_INIT menginisialisasi struktur NFC_CX_RF_DISCOVERY_CONFIG.
NfcCxDeviceDeinitialize Fungsi NfcCxDeviceDeinitialize (nfccx.h) mendesinisialisasi perangkat WDF yang dibuat selama rutinitas AddDevice.
NfcCxDeviceInitConfig Dipanggil oleh driver klien selama rutinitas AddDevice untuk melakukan fungsi DeviceInit. Selama proses ini, fungsi panggilan balik I/O berikut juga ditukar.
NfcCxDeviceInitialize Fungsi NfcCxDeviceInitialize (nfccx.h) menginisialisasi perangkat WDF yang dibuat selama rutinitas AddDevice.
NfcCxHardwareEvent Dipanggil oleh driver klien ketika peristiwa perangkat keras terjadi seperti panggilan balik D0Entry dan D0Exit untuk memulai atau menghentikan perangkat. Untuk driver yang memerlukan unduhan firmware pada inisialisasi atau boot-up, disarankan untuk memindahkan panggilan ini ke item kerja terpisah. Namun, driver klien bertanggung jawab atas hal berikut.
NfcCxNciReadNotification Dipanggil oleh driver klien ketika paket baca tersedia.
NfcCxRegisterSequenceHandler Dipanggil oleh driver klien selama inisialisasi untuk mendaftar untuk menangani urutan tertentu.
NfcCxSetLlcpConfig Dipanggil oleh driver klien untuk mengonfigurasi parameter LLCP.
NfcCxSetRfDiscoveryConfig Dipanggil oleh driver klien untuk mengonfigurasi parameter penemuan RF.
NfcCxUnregisterSequenceHandler Dipanggil oleh driver klien selama pematian perangkat untuk membatalkan pendaftaran untuk panggilan balik penangan urutan yang terdaftar sebelumnya.

Struktur

NFC_CX_CLIENT_CONFIG Struktur NFC_CX_CLIENT_CONFIG adalah parameter input untuk NfcCxDeviceInitConfig.
NFC_CX_HARDWARE_EVENT Struktur NFC_CX_HARDWARE_EVENT adalah parameter input untuk NfcCxHardwareEvent.
NFC_CX_LLCP_CONFIG Struktur NFC_CX_LLCP_CONFIG adalah parameter input untuk NfcCxSetLlcpConfig.
NFC_CX_RF_DISCOVERY_CONFIG Struktur NFC_CX_RF_DISCOVERY_CONFIG berisi pengaturan konfigurasi penemuan RF. Konfigurasi penemuan harus diselesaikan selama inisialisasi setelah memanggil NfcDxDeviceInitialize, jika tidak, kesalahan dikembalikan.
NFCCX_DRIVER_GLOBALS Struktur _NFCCX_DRIVER_GLOBALS berisi nilai global untuk driver CX Near Field Communications (NFC).
NFCRM_RADIO_STATE Struktur ini digunakan untuk menunjukkan status radio.
NFCRM_SET_RADIO_STATE Struktur ini digunakan untuk mengatur status radio. Pengemudi, dalam kasus mode pesawat, harus mempertahankan status radio dan memulihkannya ketika mode pesawat dinonaktifkan.
SCARD_IO_REQUEST Struktur ini digunakan untuk mengidentifikasi permintaan I/O kartu pintar.
SECURE_ELEMENT_AID_ROUTING_INFO SECURE_ELEMENT_AID_ROUTING_INFO adalah anggota SECURE_ELEMENT_ROUTING_TABLE_ENTRY.
SECURE_ELEMENT_ENDPOINT_INFO SECURE_ELEMENT_ENDPOINT_INFO adalah anggota SECURE_ELEMENT_ENDPOINT_LIST.
SECURE_ELEMENT_ENDPOINT_LIST Parameter output untuk IOCTL_NFCSE_ENUM_ENDPOINTS.
SECURE_ELEMENT_EVENT_INFO Struktur ini menyediakan informasi tentang peristiwa elemen yang aman.
SECURE_ELEMENT_EVENT_SUBSCRIPTION_INFO Struktur SECURE_ELEMENT_EVENT_SUBSCRIPTION_INFO adalah parameter input untuk IOCTL_NFCSE_SUBSCRIBE_FOR_EVENT.
SECURE_ELEMENT_HCE_ACTIVATION_PAYLOAD Struktur _SECURE_ELEMENT_HCE_ACTIVATION_PAYLOAD berisi pengidentifikasi koneksi unik dan jenis teknologi dan protokol NFC Forum RF.
SECURE_ELEMENT_HCE_DATA_PACKET SECURE_ELEMENT_HCE_DATA_PACKET adalah buffer input untuk IOCTL_NFCSE_HCE_REMOTE_SEND dan buffer output untuk IOCTL_NFCSE_HCE_REMOTE_RECV.
SECURE_ELEMENT_NFCC_CAPABILITIES SECURE_ELEMENT_NFCC_CAPABILITIES berisi kemampuan pengontrol NFC.
SECURE_ELEMENT_PROTO_ROUTING_INFO SECURE_ELEMENT_PROTO_ROUTING_INFO adalah anggota SECURE_ELEMENT_ROUTING_TABLE_ENTRY.
SECURE_ELEMENT_ROUTING_TABLE SECURE_ELEMENT_ROUTING_TABLE adalah parameter input untuk IOCTL_NFCSE_SET_ROUTING_TABLE.
SECURE_ELEMENT_ROUTING_TABLE_ENTRY SECURE_ELEMENT_ROUTING_TABLE_ENTRY adalah anggota SECURE_ELEMENT_ROUTING_TABLE.
SECURE_ELEMENT_SET_CARD_EMULATION_MODE_INFO SECURE_ELEMENT_SET_CARD_EMULATION_MODE_INFO adalah parameter input untuk IOCTL_NFCSE_SET_CARD_EMULATION_MODE.
SECURE_ELEMENT_TECH_ROUTING_INFO SECURE_ELEMENT_TECH_ROUTING_INFO adalah anggota SECURE_ELEMENT_ROUTING_TABLE_ENTRY.