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