IDE_HW_INITIALIZE Rückruffunktion (irb.h)
Die Miniporttreiberroutine IdeHwInitialize konfiguriert das angegebene Gerät.
Syntax
IDE_HW_INITIALIZE IdeHwInitialize;
BOOLEAN IdeHwInitialize(
[in] PVOID ChannelExtension,
[in, out] PIDE_DEVICE_PARAMETERS DeviceParameters,
[in] PIDENTIFY_DEVICE_DATA IdentifyData
)
{...}
Parameter
[in] ChannelExtension
Ein Zeiger auf die Geräteerweiterung des Miniporttreibers pro Kanal.
[in, out] DeviceParameters
Ein Zeiger auf eine Struktur vom Typ IDE_DEVICE_PARAMETERS , die das zu konfigurierende Gerät und die Geräteparameter identifiziert, mit denen das Gerät konfiguriert werden soll.
[in] IdentifyData
Ein Zeiger auf eine Struktur vom Typ IDENTIFY_DEVICE_DATA , die die vom Gerät zurückgegebenen Identifikationsdaten enthält.
Rückgabewert
IdeHwInitialize gibt TRUE zurück, wenn der Vorgang erfolgreich ist. Es wird FALSE zurückgegeben, wenn der Vorgang fehlschlägt.
Hinweise
Nachdem der Miniporttreiber die Geräte in einem Kanal aufgezählt hat, ruft er die IdeHwInitialize-Routine einmal für jedes Gerät auf, das er aufzählt. Die IdeHwInitialize-Routine muss jedes Gerät basierend auf den Informationen konfigurieren, die in der IDE_DEVICE_PARAMETERS-Struktur angegeben sind, auf die der DeviceParameters-Parameter verweist. In Ausnahmefällen kann der Miniporttreiber das Gerät mithilfe einer Reihe von Parametern konfigurieren, die sich von denen in IDE_DEVICE_PARAMETERS unterscheiden. In solchen Fällen muss der Miniporttreiber die Informationen in IDE_DEVICE_PARAMETERS aktualisieren, um den Parameterwert zu enthalten, den er tatsächlich zum Konfigurieren des Geräts verwendet hat. Nachdem die IdeHwInitialize-Routine zurückgegeben wurde, aktualisiert der Porttreiber seine zwischengespeicherten Informationen mit den Parameterwerten, die vom Miniporttreiber bereitgestellt werden.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Desktop |
| Kopfzeile | irb.h (include Irb.h) |