ChangerSetAccess 函数 (mcd.h)

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

语法

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

参数

[in] DeviceObject

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

[in] Irp

指向 IRP 的指针。

返回值

如果更改程序支持设置访问权限,ChangerSetAccess 将返回系统端口驱动程序返回的 STATUS_XXX 值或以下值之一:

STATUS_SUCCESS

STATUS_INSUFFICIENT_RESOURCES

STATUS_INVALID_PARAMETER

如果更改器不支持设置访问权限,ChangerSetAccess 将返回STATUS_INVALID_DEVICE_REQUEST。

言论

此例程是必需的。

ChangerSetAccess 锁定或解锁更改器的 IEport、门或键盘,并扩展或收回 IEport。

changer 类驱动程序在调用 changerSetAccess之前检查 I/O 堆栈位置中的输入缓冲区长度。 Irp->SystemBuffer 指向 CHANGER_SET_ACCESS 结构作为输入参数,指示要设置的元素和要执行的作。

ChangerSetAccess 首先检查不受支持的元素和作,并为它不支持的元素返回相应的状态代码。

接下来,ChangerSetAccess 将系统传递的从零开始的元素地址转换为更改程序所需的特定于设备的元素地址。

最后,ChangerSetAccess 为给定元素上的给定作生成具有 CDB 的 SRB,并将其发送到系统端口驱动程序。 要使用的命令取决于更改程序。 例如,Exabyte 微型类驱动程序使用 SCSI 命令阻止允许中等删除锁定或解锁更改器门,MOVE MEDIUM 用于扩展或收回 IEport。

要求

要求 价值
目标平台 桌面
标头 mcd.h (包括 Mcd.h、Ntddchgr.h)
IRQL PASSIVE_LEVEL

另请参阅

CHANGER_SET_ACCESS

GET_CHANGER_PARAMETERS

IOCTL_CHANGER_SET_ACCESS