struttura IDE_CHANNEL_CONFIGURATION (irb.h)

La struttura IDE_CHANNEL_CONFIGURATION contiene informazioni di configurazione per il canale indicato.

Nota

I modelli di driver di porta ATA e miniport ATA potrebbero essere modificati o non disponibili in futuro. È invece consigliabile usare driver Storport e modelli di driver miniport Storport.

Sintassi

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;

Membri

Version

Il driver della porta imposta questo membro su sizeof(IDE_CHANNEL_CONFIGURATION). Il driver miniport deve verificare che la versione sia maggiore o uguale a quella in uso.

ChannelNumber

Il driver della porta imposta questo campo sul numero assegnato per questo canale. Per i controller in modalità non nativa, il canale primario verrà sempre assegnato 0 e il canale secondario verrà sempre assegnato 1.

SupportedAdvances

Riservato; non usare.

ChannelMode

Il driver di porta imposta questo campo per informare il miniport ATA in quale modalità è in esecuzione. Esistono tre modalità possibili:

Modo	Descrizione
IdeModeNormal	Questa è la modalità completa standard in cui il miniport ATA può funzionare normalmente.
IdeModeDump	Questa è la modalità di memoria limitata che un miniport ATA opera durante l'ibernazione o crashdump. Le routine di callback e le routine di accesso al Registro di sistema non possono essere utilizzate in questa modalità.
IdeModeRemovableBay	Analogamente a IdeModeNormal, questo indica che il miniport ATA deve eseguire passaggi aggiuntivi per abilitare l'enumerazione dei dispositivi che potrebbero essere stati appena collegati a caldo su un bus ATA parallelo.

ChannelResources

Il driver di porta usa questo puntatore per passare risorse hardware miniport da usare per accedere all'HBA su un bus PCI.

NumberOfOverlappedRequests

Il driver miniport deve impostare questo campo sul numero di richieste che il canale può gestire alla volta. Per impostazione predefinita, il driver della porta imposta questo valore su 1.

MaxTargetId

Il miniport deve impostare questo membro sull'ID di destinazione massimo supportato in questo canale. In genere, si tratta di 1 minore del numero massimo di dispositivi supportati nel canale. Per impostazione predefinita, il driver di porta imposta questo valore su 1 per indicare che 2 dispositivi sono supportati in un canale.

SyncWithIsr

Indica il supporto per l'elaborazione I/O non sincronizzata nel driver miniport. Il driver miniport deve impostare questo membro su TRUE.

SupportsWmi

Indica il supporto per WMI. Il driver miniport deve impostare questo membro su TRUE.

AdvancedChannelConfiguration

Riservato per l'uso del sistema; non usare.

Fabbisogno

Requisito	Valore
intestazione	irb.h (include Irb.h)