IOCTL_NFP_DISABLE IOCTL (nfpdev.h)

客户端发送 IOCTL_NFP_DISABLE 请求，以暂时禁用订阅、发布和状态事件。当客户端想要禁用邻近感应功能但保留分配的资源以在需要时快速重新启用它们时，这非常有用。

无

无

如果请求成功，Irp-IoStatus.Status> 设置为 STATUS_SUCCESS。

否则，状态为相应的错误条件作为 NTSTATUS 代码。

有关详细信息，请参阅 NTSTATUS 值。

注解

以下是使用此 IOCTL 时所需的操作：

收到此 IOCTL 时，驱动程序必须将文件句柄标记为“已禁用”。
如果订阅句柄更改为“已禁用”，则提供程序必须从该文件句柄的“已接收”队列中删除所有消息。
如果订阅句柄为“已禁用”：
- 驱动程序必须通过清除) 队列中的现有消息以及收到新消息后立即从队列中删除 (删除该句柄的“已接收”队列，使该句柄的“已接收”队列保持零长度。
- 驱动程序必须通过 STATUS_CANCELLED 完成该句柄上的所有IOCTL_NFP_GET_NEXT_SUBSCRIBED_MESSAGE请求。
如果发布句柄为“禁用”，则提供程序不得传输发布的消息，并且它必须使用STATUS_CANCELLED完成该句柄上的所有笔 IOCTL_NFP_GET_NEXT_TRANSMITTED_MESSAGE 请求