IDE_CHANNEL_CONFIGURATION 结构 (irb.h)

IDE_CHANNEL_CONFIGURATION 结构包含所指示通道的配置信息。

注意

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

语法

typedef struct _IDE_CHANNEL_CONFIGURATION {
  USHORT                              Version;
  UCHAR                               ChannelNumber;
  SUPPORTED_ADVANCES                  SupportedAdvances;
  IDE_OPERATION_MODE                  ChannelMode;
  PIDE_MINIPORT_RESOURCES             ChannelResources;
  UCHAR                               NumberOfOverlappedRequests;
  UCHAR                               MaxTargetId;
  BOOLEAN                             SyncWithIsr;
  BOOLEAN                             SupportsWmi;
  PIDE_ADVANCED_CHANNEL_CONFIGURATION AdvancedChannelConfiguration;
} IDE_CHANNEL_CONFIGURATION, *PIDE_CHANNEL_CONFIGURATION;

成员

Version

端口驱动程序将此成员设置为 sizeof (IDE_CHANNEL_CONFIGURATION) 。 微型端口驱动程序应验证版本是否大于或等于它正在使用的版本。

ChannelNumber

端口驱动程序将此字段设置为为此通道分配的数字。 对于非本机模式控制器，将始终为主通道分配 0，辅助通道始终分配 1。

SupportedAdvances

保留值；请勿使用。

ChannelMode

端口驱动程序设置此字段以通知 ATA 微型端口在哪个模式下运行它。 有三种可能的模式：

“模式”	说明
IdeModeNormal	这是 ATA 微型端口可以正常运行的标准完整功能模式。
IdeModeDump	这是 ATA 微型端口在休眠或故障转储期间运行的有限无内存模式。 在此模式下，不能使用回调例程和注册表访问例程。
IdeModeRemovableBay	与 IdeModeNormal 类似，这表明 ATA 微型端口必须采取额外的步骤来启用可能刚刚热插到并行 ATA 总线上的设备的枚举。

ChannelResources

端口驱动程序使用此指针传递用于访问 PCI 总线上的 HBA 的微型端口硬件资源。

NumberOfOverlappedRequests

微型端口驱动程序应将此字段设置为通道一次可以处理的请求数。 默认情况下，端口驱动程序将此设置为 1。

MaxTargetId

微型端口应将此成员设置为此通道上支持的最大目标 ID。 通常，这比通道上支持的最大设备数少 1。 默认情况下，端口驱动程序将其设置为 1，表示一个通道支持 2 个设备。

SyncWithIsr

指示支持微型端口驱动程序中的未同步 I/O 处理。 微型端口驱动程序必须将此成员设置为 TRUE。

SupportsWmi

指示对 WMI 的支持。 微型端口驱动程序必须将此成员设置为 TRUE。

AdvancedChannelConfiguration

保留供系统使用;请勿使用。

要求

要求	值
Header	irb.h (包括 Irb.h)