IOCTL_STORAGE_PERSISTENT_RESERVE_OUT IOCTL (ntddstor.h)

  • 项目

泛型存储类驱动程序 (classpnp.sys) 公开 I/O 控件 (IOCTL) 接口，用于发出持久保留输出命令。 SCSI 主命令 - 2 (SPC-2) 规范中介绍了收到持久保留输出命令时存储设备的行为。 IOCTL 接口要求调用方对持久保留输出命令的物理设备具有读/写访问权限。 用户模式应用程序、服务和内核模式驱动程序可以使用此 IOCTL 来控制永久性预留。 如果从驱动程序调用，则必须从在 IRQL < DISPATCH_LEVEL运行的线程调用此 IOCTL。 此 IOCTL 使用 FILE_READ_ACCESS 和 FILE_WRITE_ACCESS进行定义，要求设备句柄同时具有读取和写入权限才能发出持久保留输出命令。

主要代码

IRP_MJ_DEVICE_CONTROL

输入缓冲区

Irp-AssociatedIrp.SystemBuffer> 处的缓冲区包含PERSISTENT_RESERVE_COMMAND结构。 必须从非分页池分配缓冲区，并且必须为目标设备和适配器正确对齐缓冲区。

PR_OUT。ServiceAction 可以是下列项之一：

  • RESERVATION_ACTION_REGISTER
  • RESERVATION_ACTION_RESERVE
  • RESERVATION_ACTION_RELEASE
  • RESERVATION_ACTION_CLEAR
  • RESERVATION_ACTION_PREEMPT
  • RESERVATION_ACTION_PREEMPT_ABORT
  • RESERVATION_ACTION_REGISTER_IGNORE_EXISTING

PR_OUT。范围可以是下列值之一：

  • RESERVATION_SCOPE_LU
  • RESERVATION_SCOPE_ELEMENT

PR_OUT。类型可以是下列类型之一：

  • RESERVATION_TYPE_WRITE_EXCLUSIVE
  • RESERVATION_TYPE_EXCLUSIVE
  • RESERVATION_TYPE_WRITE_EXCLUSIVE_REGISTRANTS
  • RESERVATION_TYPE_EXCLUSIVE_REGISTRANTS

PR_OUT。ParameterList 用于保存 PRO_PARAMETER_LIST 结构。 此结构是必需的，并且必须与 PERSISTENT_RESERVE_COMMAND 结构的其余部分连续。

输入缓冲区长度

PERSISTENT_RESERVE_COMMAND 结构的长度。

输出缓冲区

无。

输出缓冲区长度

无。

状态块

“ 信息” 字段设置为零。

“ 状态” 字段设置为以下值之一。

值 含义
STATUS_DEVICE_BUSY (ERROR_BUSY) 命令因预留冲突 (而失败，有关详细信息，请参阅 SCSI 主命令 - 2 (SPC-2) 规范) 。
STATUS_INFO_LENGTH_MISMATCH IOCTL 的输入缓冲区长度小于 sizeof (PERSISTENT_RESERVE_COMMAND) 或 PERSISTENT_RESERVE_COMMAND 数据结构中指定的大小小于 sizeof (PERSISTENT_RESERVE_COMMAND) 。
STATUS_INVALID_DEVICE_REQUEST (ERROR_INVALID_FUNCTION) 存储驱动程序不支持 I/O 控制代码 (IOCTL_STORAGE_PERSISTENT_RESERVE_OUT) 。
STATUS_INVALID_PARAMETER (ERROR_INVALID_PARAMETER) 输入缓冲区结构大小错误或填充错误。
STATUS_INVALID_USER_BUFFER (ERROR_INVALID_USER_BUFFER) 输入缓冲区未针对设备或适配器正确对齐。 仅当驱动程序将 IOCTL 发送到存储堆栈时，才能返回此状态。 当用户模式应用程序通过 DeviceIoControl API 发送 IOCTL 时，不会返回此状态，因为 I/O 管理器会自动对齐缓冲区。
STATUS_IO_DEVICE_ERROR (ERROR_IO_DEVICE) 设备不支持持久保留输出命令。
STATUS_SUCCESS 操作成功。

要求

要求 值
Header ntddstor.h (包括 Ntddstor.h)