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 |
支援的最低伺服器 | 不支援 |
目標平臺 | 窗戶 |
標頭 | nfccx.h (包括 Ncidef.h) |
連結庫 | Nfccxstub.lib |
DLL | NfcCx.dll |