共用方式為

IDE_CHANNEL_INIT回呼函式 （irb.h）

  • 發行項

AtaChannelInitRoutine 迷你埠驅動程式例程會初始化迷你埠驅動程式的通道介面。

注意

ATA 埠驅動程式和 ATA 迷你埠驅動程式模型未來可能會改變或無法使用。 相反地，我們建議使用 Storport 驅動程式 和 Storport miniport 驅動程式模型。

語法

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 例程必須初始化 AtaChannelInitRoutine 成員 IDE_CONTROLLER_INTERFACE，以指向迷你埠驅動程式的 AtaChannelInitRoutine 例程。

  3. 埠驅動程式會使用控件動作 IdeStart 呼叫 AtaAdapterControl 例程。 AtaChannelInitRoutine 會針對 ControllerConfiguration 結構中指定的每一個 NumberOfChannels 呼叫一次，AtaAdapterControl 例程時，AtaAdapterControl 處理 IdeStart 動作。

要求

要求 價值
目標平臺 桌面
標頭 irb.h （包括 Irb.h）

另請參閱

AtaPortInitializeEx

IDE_CHANNEL_INTERFACE

IDE_CONTROLLER_INTERFACE