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 動作時，AtaChannelInitRoutine 會針對 ControllerConfiguration 結構中指定的每一個 NumberOfChannels 呼叫一次。

規格需求

需求 值
目標平台 桌面
標頭 irb.h (包含 Irb.h)

另請參閱

AtaPortInitializeEx

IDE_CHANNEL_INTERFACE

IDE_CONTROLLER_INTERFACE