changerGetParameters 函数 (mcd.h)

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

语法

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

[in] DeviceObject

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

[in] Irp

指向 IRP 的指针。

ChangerGetParameters 返回系统端口驱动程序返回的 STATUS_XXX 值或以下值之一：

STATUS_SUCCESS

STATUS_INFO_LENGTH_MISMATCH

STATUS_INSUFFICIENT_RESOURCES

此例程是必需的。

ChangerGetParameters 返回变更器的参数，包括其元素的数量和类型以及它支持的功能。

在调用 ChangerGetParameters 之前，变更程序类驱动程序会检查 I/O 堆栈位置中的输出缓冲区长度。如果输出缓冲区长度小于大小 (GET_CHANGER_PARAMETERS) 则更换器类驱动程序返回值STATUS_INFO_LENGTH_MISMATCH。

ChangerGetParameters 通过使用 CDB 生成 SRB 从设备中检索参数数据，以获取 SCSI 参数标头页、元素地址页、传输几何图形页和设备功能页或此数据的非 SCSI 等效项。

然后，ChangerGetParameters 在 Irp-AssociatedIrp.SystemBuffer> 中填充GET_CHANGER_PARAMETERS结构，然后再返回到变更程序类驱动程序。