IDE_CHANNEL_INIT Rückruffunktion (irb.h)
Die AtaChannelInitRoutine-Miniporttreiberroutine-Routine initialisiert die Kanalschnittstelle des Miniporttreibers.
Hinweis
Die Modelle ATA-Porttreiber und ATA-Miniporttreiber sind möglicherweise geändert oder in Zukunft nicht mehr verfügbar. Stattdessen wird empfohlen, die Modelle Storport-Treiber und Storport-Miniporttreiber zu verwenden.
Syntax
IDE_CHANNEL_INIT IdeChannelInit;
BOOLEAN IdeChannelInit(
PVOID ChannelExtension,
PIDE_CHANNEL_INTERFACE ChannelInterface,
PVOID InitContext
)
{...}
Parameter
ChannelExtension
[in] Ein Zeiger auf die Miniport-Treiberkanalerweiterung.
ChannelInterface
[in, out] Zeiger 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 gibt TRUE zurück, wenn die Initialisierung erfolgreich war. Es wird FALSE zurückgegeben, wenn die Initialisierung fehlgeschlagen ist.
Hinweise
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. In der folgenden Sequenz wird beschrieben, wie der Miniporttreiber und der Porttreiber interagieren, um einen Kanal zu initialisieren:
In seiner DriverEntry-Routine ruft der Miniporttreiber die AtaPortInitializeEx-Bibliotheksroutine des Porttreibers auf, um die Initialisierung des Controllers und des Miniporttreibers zu starten.
Wenn der Miniporttreiber die Kanalschnittstelle unterstützt, muss die DriverEntry-Routine das AtaChannelInitRoutine-Element von IDE_CONTROLLER_INTERFACE initialisieren, um auf die AtaChannelInitRoutine-Routine des Miniporttreibers zu verweisen.
Der Porttreiber ruft die AtaAdapterControl-Routine mithilfe der Steuerungsaktion IdeStart auf. AtaChannelInitRoutine wird einmal für jeden NumberOfChannels aufgerufen, der in der ControllerConfiguration-Struktur angegeben ist, die von der AtaAdapterControl-Routine zurückgegeben wird, wenn AtaAdapterControl eine IdeStart-Aktion verarbeitet.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Desktop |
| Kopfzeile | irb.h (include Irb.h) |