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 返回更改器的参数,包括其元素的数量和类型及其支持的功能。
changer 类驱动程序在调用 changerGetParameters之前检查 I/O 堆栈位置中的输出缓冲区长度。 如果输出缓冲区长度小于 sizeof(GET_CHANGER_PARAMETERS),则 changer 类驱动程序返回的值为 STATUS_INFO_LENGTH_MISMATCH。
ChangerGetParameters 通过使用 CDB 生成 SRB 来检索设备中的参数数据,以获取 SCSI 参数标头页、元素地址页、传输几何图形页和设备功能页,或此数据的非 SCSI 等效项。
ChangerGetParameters 然后在 Irp填充GET_CHANGER_PARAMETERS结构 ->AssociatedIrp.SystemBuffer,然后返回到 changer 类驱动程序。
要求
要求 | 价值 |
---|---|
目标平台 | 桌面 |
标头 | mcd.h (包括 Mcd.h、Ntddchgr.h) |
IRQL | PASSIVE_LEVEL |