AtaPortBuildRequestSenseIrb 函数 (irb.h)

AtaPortBuildRequestSenseIrb 例程生成并返回操作代码SCSIOP_REQUEST_SENSE的 IRB。

注意 ATA 端口驱动程序和 ATA 微型端口驱动程序模型将来可能会更改或不可用。相反，我们建议使用 Storport 驱动程序和 Storport 微型端口驱动程序模型。

语法

PIDE_REQUEST_BLOCK AtaPortBuildRequestSenseIrb(
  [in] PVOID              ChannelExtension,
  [in] PIDE_REQUEST_BLOCK Irb
);

[in] ChannelExtension

指向通道扩展的指针。

[in] Irb

指向 IDE_REQUEST_BLOCK 类型的结构的指针，该结构定义将为其发出请求感知 (IRB) 失败的 IDE 请求块。

如果操作成功， AtaPortBuildRequestSenseIrb 例程将返回指向它分配的请求感知 IRB 的指针。如果操作失败， AtaPortBuildRequestSenseIrb 将返回 NULL。

如果设备不支持自动请求感知，微型端口驱动程序必须使用 AtaPortBuildRequestSenseIrb 生成 IRB 以收集感知数据，然后将其发送到设备。在相应的请求感知 IRB 完成之前，微型端口驱动程序不得完成原始 IRB。请注意，ATA 设备不需要任何请求感知数据。

有关 SCSIOP_REQUEST_SENSE 命令的说明，请参阅 SCSI-3 规范。

微型端口驱动程序每个逻辑单元只能有一个未完成的请求感知 IRB。