IDE_HW_INITIALIZE回呼函式 (irb.h)
IdeHwInitialize 迷你埠驅動程式例程會設定指定的裝置。
附注 ATA 埠驅動程式和 ATA 迷你埠驅動程式模型未來可能會改變或無法使用。 相反地,我們建議使用 Storport 驅動程式 和 Storport miniport 驅動程式模型。
語法
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 。
言論
在迷你埠驅動程式列舉通道上的裝置之後,它會針對它列舉的每個裝置呼叫 IdeHwInitialize 例程一次。 IdeHwInitialize 例程必須根據 IDE_DEVICE_PARAMETERS 結構中指定的資訊來設定每個裝置,DeviceParameters 參數所指向。 在特殊情況下,迷你埠驅動程式可以使用一組不同於 IDE_DEVICE_PARAMETERS中包含的參數來設定裝置。 在這種情況下,迷你埠驅動程序必須更新 IDE_DEVICE_PARAMETERS 中的資訊,以包含它實際用來設定裝置的參數值。 IdeHwInitialize 例程傳回之後,埠驅動程式會使用迷你埠驅動程式所提供的參數值來更新其快取資訊。
要求
要求 | 價值 |
---|---|
目標平臺 | 桌面 |
標頭 | irb.h (包括 Irb.h) |