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 |
另請參閱
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應