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。