IDE_HW_INITIALIZE Rückruffunktion (irb.h)

Die IdeHwInitialize Miniporttreiberroutine konfiguriert das angegebene Gerät.

Hinweis Der ATA-Porttreiber und die ATA Miniport-Treibermodelle können in Zukunft geändert oder nicht verfügbar sein. Stattdessen empfehlen wir die Verwendung des Storport-Treibers und Storport Miniport Treibermodelle.

 

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 den Miniporttreiber pro Kanalgeräteerweiterung.

[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 identifizierenden Daten enthält, die vom Gerät zurückgegeben werden.

Rückgabewert

IdeHwInitialize- gibt TRUE- zurück, wenn der Vorgang erfolgreich ist. Sie gibt FALSE- zurück, wenn der Vorgang fehlschlägt.

Bemerkungen

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 aufgezählt wird. Die IdeHwInitialize Routine muss jedes Gerät basierend auf den Informationen konfigurieren, die in der IDE_DEVICE_PARAMETERS Struktur angegeben sind, auf die durch den DeviceParameters Parameter verwiesen wird. In Ausnahmefällen kann der Miniporttreiber das Gerät mithilfe einer Reihe von Parametern konfigurieren, die sich von denen unterscheiden, die in IDE_DEVICE_PARAMETERSenthalten sind. In solchen Fällen muss der Miniporttreiber die Informationen in IDE_DEVICE_PARAMETERS so aktualisieren, dass er den Parameterwert enthält, 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
Header-	irb.h (include Irb.h)

Siehe auch

IDENTIFY_DEVICE_DATA

IDE_DEVICE_PARAMETERS