IDE_CHANNEL_CONFIGURATION-Struktur (irb.h)

Die IDE_CHANNEL_CONFIGURATION-Struktur enthält Konfigurationsinformationen für den angegebenen Kanal.

Hinweis

Die Modelle ATA-Porttreiber und ATA-Miniporttreiber können in Zukunft geändert oder nicht mehr verfügbar sein. Stattdessen wird empfohlen, die Modelle Storport-Treiber und Storport-Miniporttreiber zu verwenden.

Syntax

typedef struct _IDE_CHANNEL_CONFIGURATION {
  USHORT                              Version;
  UCHAR                               ChannelNumber;
  SUPPORTED_ADVANCES                  SupportedAdvances;
  IDE_OPERATION_MODE                  ChannelMode;
  PIDE_MINIPORT_RESOURCES             ChannelResources;
  UCHAR                               NumberOfOverlappedRequests;
  UCHAR                               MaxTargetId;
  BOOLEAN                             SyncWithIsr;
  BOOLEAN                             SupportsWmi;
  PIDE_ADVANCED_CHANNEL_CONFIGURATION AdvancedChannelConfiguration;
} IDE_CHANNEL_CONFIGURATION, *PIDE_CHANNEL_CONFIGURATION;

Member

Version

Der Porttreiber legt diesen Member auf sizeof(IDE_CHANNEL_CONFIGURATION) fest. Der Miniporttreiber sollte überprüfen, ob die Version größer oder gleich der version ist, die er verwendet.

ChannelNumber

Der Porttreiber legt dieses Feld auf die für diesen Kanal zugewiesene Nummer fest. Bei Controllern im nicht nativen Modus wird dem primären Kanal immer 0 und dem sekundären Kanal immer 1 zugewiesen.

SupportedAdvances

Reserviert; nicht verwenden.

ChannelMode

Der Porttreiber legt dieses Feld fest, um den ATA-Miniport darüber zu informieren, in welchem Modus er ausgeführt wird. Es gibt drei mögliche Modi:

Mode	BESCHREIBUNG
IdeModeNormal	Dies ist der Standardmäßige Modus für vollständige Funktionen, in dem der ATA-Miniport normal ausgeführt werden kann.
IdeModeDump	Dies ist der eingeschränkte Modus ohne Arbeitsspeicher, in dem ein ATA-Miniport während des Ruhezustands oder Absturzvorgangs ausgeführt wird. Rückrufroutinen und Registrierungszugriffsroutinen können in diesem Modus nicht verwendet werden.
IdeModeRemovableBay	Ähnlich wie bei IdeModeNormal weist dies darauf hin, dass der ATA-Miniport zusätzliche Schritte ausführen muss, um die Enumeration von Geräten zu aktivieren, die möglicherweise gerade an einen Parallel ATA-Bus angeschlossen wurden.

ChannelResources

Der Porttreiber verwendet diesen Zeiger, um Miniporthardwareressourcen zu übergeben, die für den Zugriff auf den HBA auf einem PCI-Bus verwendet werden.

NumberOfOverlappedRequests

Der Miniporttreiber sollte dieses Feld auf die Anzahl der Anforderungen festlegen, die der Kanal gleichzeitig verarbeiten kann. Standardmäßig legt der Porttreiber dies auf 1 fest.

MaxTargetId

Der Miniport sollte diesen Member auf die maximale Ziel-ID festlegen, die für diesen Kanal unterstützt wird. In der Regel ist dies 1 kleiner als die maximale Anzahl von Geräten, die auf dem Kanal unterstützt werden. Standardmäßig legt der Porttreiber diesen Wert auf 1 fest, um anzugeben, dass 2 Geräte in einem Kanal unterstützt werden.

SyncWithIsr

Gibt die Unterstützung für die nicht synchronisierte E/A-Verarbeitung im Miniporttreiber an. Der Miniporttreiber muss diesen Member auf TRUE festlegen.

SupportsWmi

Gibt die Unterstützung für WMI an. Der Miniporttreiber muss diesen Member auf TRUE festlegen.

AdvancedChannelConfiguration

Für die Systemnutzung reserviert; nicht verwenden.

Anforderungen

Anforderung	Wert
Header	irb.h (include Irb.h)