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 等效项。

然后,ChangerGetParametersIrp-AssociatedIrp.SystemBuffer> 中填充GET_CHANGER_PARAMETERS结构,然后返回到 changer 类驱动程序。

要求

   
目标平台 桌面
Header mcd.h (包括 Mcd.h、Ntddchgr.h)
IRQL PASSIVE_LEVEL

另请参阅

GET_CHANGER_PARAMETERS

IOCTL_CHANGER_GET_PARAMETERS