IDE_HW_INITIALIZEコールバック関数 (irb.h)

IdeHwInitialize ミニポート ドライバー ルーチンは、指定されたデバイスを構成します。

構文

IDE_HW_INITIALIZE IdeHwInitialize;

BOOLEAN IdeHwInitialize(
  [in]      PVOID ChannelExtension,
  [in, out] PIDE_DEVICE_PARAMETERS DeviceParameters,
  [in]      PIDENTIFY_DEVICE_DATA IdentifyData
)
{...}

パラメーター

[in] ChannelExtension

チャネルごとのミニポート ドライバーデバイス拡張機能へのポインター。

[in, out] DeviceParameters

構成するデバイスと、デバイスの構成に 使用するデバイス パラメーターを識別するIDE_DEVICE_PARAMETERS型の構造体へのポインター。

[in] IdentifyData

デバイスによって返される識別データを含む IDENTIFY_DEVICE_DATA 型の構造体へのポインター。

戻り値

操作が成功した場合、IdeHwInitialize は TRUE を返します。 操作が失敗した場合は FALSE を 返します。

注釈

ミニポート ドライバーは、チャネル上のデバイスを列挙した後、列挙するデバイスごとに 1 回 IdeHwInitialize ルーチンを呼び出します。 IdeHwInitialize ルーチンは、DeviceParameters パラメーターによって指されるIDE_DEVICE_PARAMETERS構造体で指定された情報に基づいて各デバイスを構成する必要があります。 例外的な場合、ミニポート ドライバーは、 IDE_DEVICE_PARAMETERSに含まれているパラメーターとは異なるパラメーターのセットを使用して、デバイスを構成できます。 このような場合、ミニポート ドライバーは、デバイスの構成に実際に使用されるパラメーター値を含む IDE_DEVICE_PARAMETERS の情報を更新する必要があります。 IdeHwInitialize ルーチンが返された後、ポート ドライバーは、ミニポート ドライバーによって提供されるパラメーター値を使用してキャッシュされた情報を更新します。

要件

こちらもご覧ください

IDENTIFY_DEVICE_DATA

IDE_DEVICE_PARAMETERS