NfcCxHardwareEvent 函式 (nfccx.h)

當硬體事件發生時,用戶端驅動程式會呼叫,例如 D0Entry 和 D0Exit 回呼來啟動或停止裝置。 對於在初始化或開機時需要韌體下載的驅動程序,建議將此呼叫移至個別的工作專案。 不過,客戶端驅動程式負責下列事項:

  • 用戶端驅動程序應該先取得閑置電源參考,再將工作專案排入佇列。 當工作專案完成時,必須卸除參考。 這可確保閑置電源管理不會在工作專案執行時進入 D3。
  • 用戶端驅動程序應該與其他裝置回呼同步處理工作專案。 這通常是透過 WDF_WORKITEM_CONFIG 中的 AutomaticSerialization 選項來達成,而且 WDFWORKITEM 的父代是 WDFDEVICE,或是讓工作專案回呼明確取得裝置鎖定,也就是 WDFDEVICE 上的 WdfObjectAcquireLock
  • 如果硬體事件呼叫從工作項目失敗,用戶端驅動程序應該重新啟動或解除鎖定驅動程式,以防止它處於不良狀態。 這可以使用 [重新啟動] 或 [卸除] 選項來達成。

語法

NTSTATUS NfcCxHardwareEvent(
  WDFDEVICE              Device,
  PNFC_CX_HARDWARE_EVENT HardwareEvent
);

參數

Device

架構裝置物件的句柄。

HardwareEvent

NFC_CX_HARDWARE_EVENT 結構的指標。

傳回值

如果作業成功,函式會傳回STATUS_SUCCESS。

規格需求

需求
最低支援的用戶端 Windows 10
最低支援的伺服器 都不支援
目標平台 Windows
標頭 nfccx.h (包括 Ncidef.h)
程式庫 Nfccxstub.lib
Dll NfcCx.dll

另請參閱

NFC 類別延伸模組設計指南

接近現場通訊 (NFC) 設計指南