IOCTL_POINT_OF_SERVICE_RETAIN_DEVICE IOCTL (pointofservicedriverinterface.h)

此 I/O 控制函数用于在设备上保留声明,当客户端收到另一个客户端正在对设备上的声明提出异议的通知。

主要代码

IRP_MJ_DEVICE_CONTROL

输入缓冲区

不与此操作一起使用;设置为 NULL。

输入缓冲区长度

未与此操作一起使用;设置为 0 (零) 。

输出缓冲区

不与此操作一起使用;设置为 NULL。

输出缓冲区长度

未与此操作一起使用;设置为 0 (零)

状态块

如果成功,则返回 TRUE ;否则,返回 FALSE

注解

要获得更多的错误信息,请调用 GetLastError。 以下列表显示了常见错误值:

  • STATUS_ACCESS_DENIED:设备当前由另一个客户端声明。

  • STATUS_DEVICE_NOT_READY:POS 库尚未成功初始化。

此 IOCTL 仅在客户端之前已调用 IOCTL_POINT_OF_SERVICE_CLAIM_DEVICE 时才有效。

处理此 IOCTL 时,驱动程序可以调用 PosCxRetainDevice。 驱动程序编写器不需要处理声明争用,因为 PosCx 库确定谁获取声明。

要求

要求
Header pointofservicedriverinterface.h (包括 Pointofservicedriverinterface.h)