错误处理

本主题讨论 NFC 客户端的错误处理要求。

  • NFC 客户端驱动程序负责在向控制器执行写入请求时遇到错误时通知 NFC CX。 收到错误状态时的 NFC CX 将执行重试、恢复或输入错误状态。

  • NFC 客户端驱动程序可以在完成序列调用时报告错误。 根据当前状态,NFC CX 将进入恢复或输入错误状态。

  • 当 NFCC 遇到崩溃时,它预期会向主机发送CORE_RESET_NTF。 收到 CORE_RESET_NTF 后,NFC CX 将执行相应的恢复操作。

  • 当客户端检测到不可恢复的错误时,它可以通知 NFC CX 通过 HostActionRestart 重启完整驱动程序,或请求它使用 HostActionUnload 卸载驱动程序。

  • 如果 NFC 客户端需要触发用户模式崩溃(例如,检测到内存损坏),则应使用 WDF 验证器 API,通过使用为 NFC 客户端驱动程序保留的范围内的 bug 检查代码来触发崩溃(有关详细信息,请参阅 NfcCxBugCodes.h)。 由于默认情况下启用了进程共享,因此 NFC 客户端驱动程序必须仅在绝对必要时使用这一机制,否则可能会导致 WUDF 驱动程序主机进程中的其他驱动程序发生故障。