IDE_CHANNEL_INIT回调函数 (irb.h)

  • 项目

AtaChannelInitRoutine 微型端口驱动程序例程初始化微型端口驱动程序的通道接口。

注意

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

语法

IDE_CHANNEL_INIT IdeChannelInit;

BOOLEAN IdeChannelInit(
  PVOID ChannelExtension,
  PIDE_CHANNEL_INTERFACE ChannelInterface,
  PVOID InitContext
)
{...}

参数

ChannelExtension

[in]指向微型端口驱动程序通道扩展的指针。

ChannelInterface

[in， out]指向包含所指示通道接口信息的 IDE_CHANNEL_INTERFACE 结构的指针。

InitContext

[in， out]指向控制器扩展的指针。

返回值

如果初始化成功，AtaChannelInitRoutine 将返回 TRUE。 如果初始化失败，则返回 FALSE。

注解

支持通道接口的供应商提供的微型端口驱动程序必须实现 AtaChannelInitRoutine 例程来初始化控制器的通道。 具体而言， AtaChannelInitRoutine 例程必须完成 IDE_CHANNEL_INTERFACE 结构的初始化。 以下顺序描述微型端口驱动程序和端口驱动程序如何交互以初始化通道：

  1. 在其 DriverEntry 例程中，微型端口驱动程序调用端口驱动程序的 AtaPortInitializeEx 库例程来启动控制器和微型端口驱动程序的初始化。

  2. 如果微型端口驱动程序支持通道接口，DriverEntry 例程必须初始化 IDE_CONTROLLER_INTERFACE 的 AtaChannelInitRoutine 成员，以指向微型端口驱动程序的 AtaChannelInitRoutine 例程。

  3. 端口驱动程序使用控制操作 IdeStart 调用 AtaAdapterControl 例程。 当 AtaAdapterControl 处理 IdeStart 操作时，AtaAdapterControl 例程返回的 ControllerConfiguration 结构中指定的每个 NumberOfChannels 都会调用 AtaChannelInitRoutine 一次。

要求

要求 值
目标平台 桌面
标头 irb.h (包括 Irb.h)

另请参阅

AtaPortInitializeEx

IDE_CHANNEL_INTERFACE

IDE_CONTROLLER_INTERFACE