SCSI_PASS_THROUGH 结构 (ntddscsi.h)

项目
02/29/2024

SCSI_PASS_THROUGH 结构与 IOCTL_SCSI_PASS_THROUGH 请求结合使用，以指示端口驱动程序将嵌入式 SCSI 命令发送到目标设备。

注意 SCSI 端口驱动程序和 SCSI 微型端口驱动程序模型将来可能会更改或不可用。建议改用 Storport 驱动程序和 Storport 微型端口驱动程序模型。

语法

typedef struct _SCSI_PASS_THROUGH {
  USHORT    Length;
  UCHAR     ScsiStatus;
  UCHAR     PathId;
  UCHAR     TargetId;
  UCHAR     Lun;
  UCHAR     CdbLength;
  UCHAR     SenseInfoLength;
  UCHAR     DataIn;
  ULONG     DataTransferLength;
  ULONG     TimeOutValue;
  ULONG_PTR DataBufferOffset;
  ULONG     SenseInfoOffset;
  UCHAR     Cdb[16];
} SCSI_PASS_THROUGH, *PSCSI_PASS_THROUGH;

成员

Length

包含 size of (SCSI_PASS_THROUGH) 的值。

ScsiStatus

报告 HBA 或目标设备返回的 SCSI 状态。

PathId

指示请求的 SCSI 端口或总线。

TargetId

指示总线上的目标控制器或设备。

Lun

指示设备的逻辑单元号。

CdbLength

指示 SCSI 命令描述符块的大小（以字节为单位）。

SenseInfoLength

指示请求感知缓冲区的大小（以字节为单位）。

DataIn

此字段必须具有以下三个值之一：

#######

DataTransferLength

指示数据缓冲区的大小（以字节为单位）。许多设备传输预定义长度的数据区块。 DataTransferLength 中的值必须是设备指定的此预定义最小长度的整数倍。如果发生不足，微型端口驱动程序必须将此成员更新为实际传输的字节数。

TimeOutValue

指示请求在端口驱动程序认为超时之前可以执行的间隔（以秒为单位）。

DataBufferOffset

包含从此结构开头到数据缓冲区的偏移量。偏移量必须符合设备的数据对齐要求。

SenseInfoOffset

从此结构的开头到请求感知缓冲区的偏移量。

Cdb[16]

指定要发送到目标设备的 SCSI 命令描述符块。

注解

SCSI_PASS_THROUGH结构与 IOCTL_SCSI_PASS_THROUGH一起使用，这是缓冲设备控制请求。若要绕过系统内存中的缓冲，调用方应使用 IOCTL_SCSI_PASS_THROUGH_DIRECT。处理IOCTL_SCSI_PASS_THROUGH_DIRECT请求时，系统会锁定用户内存中的缓冲区，设备将直接访问此内存。

SCSI_PASS_THROUGH的成员大致对应于 SCSI_REQUEST_BLOCK 结构的成员。 DataIn 成员的值对应于分配给 SCSI_REQUEST_BLOCK SrbFlags 成员的SCSI_IOCTL_DATA_IN、SCSI_IOCTL_DATA_OUT和SCSI_IOCTL_DATA_UNSPECIFIED标志。