IDE_CHANNEL_INIT Rückruffunktion (irb.h)

Artikel
02/07/2025

Die AtaChannelInitRoutine Miniporttreiberroutine initialisiert die Kanalschnittstelle des Miniporttreibers.

Anmerkung

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_CHANNEL_INIT IdeChannelInit;

BOOLEAN IdeChannelInit(
  PVOID ChannelExtension,
  PIDE_CHANNEL_INTERFACE ChannelInterface,
  PVOID InitContext
)
{...}

Parameter

ChannelExtension

[in] Ein Zeiger auf die Erweiterung des Miniporttreiberkanals.

ChannelInterface

[in, out] Zeigen Sie auf eine IDE_CHANNEL_INTERFACE Struktur, die Schnittstelleninformationen für den angegebenen Kanal enthält.

InitContext

[in, out] Ein Zeiger auf die Controllererweiterung.

Rückgabewert

AtaChannelInitRoutine TRUE zurück, wenn die Initialisierung erfolgreich war. Er gibt FALSE zurück, wenn die Initialisierung fehlgeschlagen ist.

Bemerkungen

Ein vom Anbieter bereitgestellter Miniporttreiber, der die Kanalschnittstelle unterstützt, muss eine AtaChannelInitRoutine Routine implementieren, um die Kanäle des Controllers zu initialisieren. Insbesondere muss die AtaChannelInitRoutine Routine die Initialisierung der IDE_CHANNEL_INTERFACE Struktur abschließen. Die folgende Sequenz beschreibt, wie der Miniporttreiber und der Porttreiber interagieren, um einen Kanal zu initialisieren:

Während der DriverEntry Routine ruft der Miniporttreiber die AtaPortInitializeEx Bibliotheksroutine auf, um die Initialisierung des Controllers und des Miniporttreibers zu starten.
Wenn der Miniporttreiber die Kanalschnittstelle unterstützt, muss die DriverEntry-Routine die AtaChannelInitRoutine Mitglied der IDE_CONTROLLER_INTERFACE initialisieren, um auf die AtaChannelInitRoutine Routine des Miniporttreibers zu verweisen.
Der Porttreiber ruft die AtaAdapterControl Routine mithilfe der Steuerelementaktion IdeStart auf. AtaChannelInitRoutine wird für jede in der ControllerConfiguration-Struktur angegebene NumberOfChannels, die von der AtaAdapterControl Routine zurückgegeben wird, einmal aufgerufen, wenn AtaAdapterControl eine IdeStart--Aktion behandelt.

Anforderungen

Anforderung	Wert
Zielplattform-	Desktop
Header-	irb.h (include Irb.h)

Siehe auch

AtaPortInitializeEx

IDE_CHANNEL_INTERFACE

IDE_CONTROLLER_INTERFACE

Freigeben über