IDE_HW_INITIALIZE callback function (irb.h)

Article
02/22/2024

The IdeHwInitialize miniport driver routine configures the indicated device.

Note The ATA port driver and ATA miniport driver models may be altered or unavailable in the future. Instead, we recommend using the Storport driver and Storport miniport driver models.

Syntax

IDE_HW_INITIALIZE IdeHwInitialize;

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

Parameters

[in] ChannelExtension

A pointer to the miniport driver per channel device extension.

[in, out] DeviceParameters

A pointer to a structure of type IDE_DEVICE_PARAMETERS that identifies the device to configure and the device parameters with which to configure the device.

[in] IdentifyData

A pointer to a structure of type IDENTIFY_DEVICE_DATA that contains the identify data that is returned by the device.

Return value

IdeHwInitialize returns TRUE if the operation succeeds. It returns FALSE if the operation fails.

Remarks

After the miniport driver enumerates the devices on a channel, it calls the IdeHwInitialize routine one time for each device it enumerates. The IdeHwInitialize routine must configure each device based on the information that is specified in the IDE_DEVICE_PARAMETERS structure, pointed to by the DeviceParameters parameter. In exceptional cases, the miniport driver can configure the device by using a set of parameters that differ from those contained in IDE_DEVICE_PARAMETERS. In such cases, the miniport driver must update the information in IDE_DEVICE_PARAMETERS to contain the parameter value that it actually used to configure the device. After the IdeHwInitialize routine returns, the port driver updates its cached information with the parameter values that are provided by the miniport driver.

Requirements

Requirement	Value
Target Platform	Desktop
Header	irb.h (include Irb.h)