ChangerMoveMedium 函数 (mcd.h)

ChangerMoveMedium 使用 IOCTL 代码 IOCTL_CHANGER_MOVE_MEDIUM处理设备控制 IRP 的设备特定方面。

语法

NTSTATUS ChangerMoveMedium(
  [in] PDEVICE_OBJECT DeviceObject,
  [in] PIRP           Irp
);

[in] DeviceObject

指向表示更换器的设备对象的指针。

[in] Irp

指向 IRP 的指针。

ChangerMoveMedium 返回系统端口驱动程序返回的状态，或以下值之一：

STATUS_SUCCESS

STATUS_DESTINATION_ELEMENT_FULL

STATUS_INVALID_ELEMENT_ADDRESS

STATUS_INVALID_DEVICE_REQUEST

STATUS_INVALID_PARAMETER

STATUS_INSUFFICIENT_RESOURCES

STATUS_SOURCE_ELEMENT_EMPTY

此例程是必需的。

ChangerMoveMedium 将一段媒体从一个元素移到另一个元素。

在调用 ChangerMoveMedium 之前，变更程序类驱动程序会检查 I/O 堆栈位置中的输入缓冲区长度。 Irp-SystemBuffer>指向CHANGER_MOVE_MEDIUM结构，该结构指示传输元素、源、目标以及是否翻转媒体。

ChangerMoveMedium 首先验证传输、源和目标元素地址是否有效，然后将从零开始的元素地址转换为特定于设备的地址。然后，它使用 CDB 生成 SRB 来移动介质片段，并将其发送到系统端口驱动程序。

ChangerMoveMedium 在返回到变更程序类驱动程序之前，将 I/O 状态块中的 “信息 ”字段设置为 sizeof (CHANGER_MOVE_MEDIUM) 。