IDE_HW_INITIALIZE callback function (irb.h)
The IdeHwInitialize miniport driver routine configures the indicated device.
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) |