Fungsi NfcCxHardwareEvent (nfccx.h)

  • Artikel

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-hal berikut:

  • Driver klien harus mengambil referensi daya menganggur sebelum mengantre item kerja. Referensi perlu dihilangkan ketika item kerja selesai. Ini memastikan manajemen daya diam tidak menyebabkan driver masuk ke D3 saat item kerja berjalan.
  • Driver klien harus menyinkronkan item kerja dengan panggilan balik perangkat lain. Ini biasanya dicapai oleh opsi AutomaticSerialization dalam WDF_WORKITEM_CONFIG dan meminta induk WDFWORKITEM menjadi WDFDEVICE atau dengan meminta panggilan balik item kerja secara eksplisit mengambil kunci perangkat yaitu WdfObjectAcquireLock di WDFDEVICE.
  • Jika panggilan peristiwa perangkat keras gagal dari item kerja, driver klien harus memulai ulang atau membuka kunci driver untuk mencegahnya dalam keadaan buruk. Ini dapat dicapai menggunakan opsi Hidupkan Ulang atau Bongkar.

Sintaks

NTSTATUS NfcCxHardwareEvent(
  WDFDEVICE              Device,
  PNFC_CX_HARDWARE_EVENT HardwareEvent
);

Parameter

Device

Handel ke objek perangkat kerangka kerja.

HardwareEvent

Penunjuk ke struktur NFC_CX_HARDWARE_EVENT .

Mengembalikan nilai

Jika operasi berhasil, fungsi akan mengembalikan STATUS_SUCCESS.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows 10
Server minimum yang didukung Tidak ada yang didukung
Target Platform Windows
Header nfccx.h (termasuk Ncidef.h)
Pustaka Nfccxstub.lib
DLL NfcCx.dll

Lihat juga

Panduan desain ekstensi kelas NFC

Panduan desain komunikasi bidang dekat (NFC)