struttura IDE_CONTROLLER_INTERFACE (irb.h)

La struttura IDE_CONTROLLER_INTERFACE viene usata per passare le informazioni di configurazione del controller tra il driver di porta e il driver miniport.

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_CONTROLLER_INTERFACE {
  USHORT                   Version;
  USHORT                   Reserved;
  ULONG                    ControllerExtensionSize;
  ULONG                    ChannelExtensionSize;
  ULONG                    AlignmentMask;
  IDE_CHANNEL_INIT         AtaChannelInitRoutine;
  IDE_CHANNEL_ENABLED      AtaControllerChannelEnabled;
  IDE_TRANSFER_MODE_SELECT AtaControllerTransferModeSelect;
  IDE_ADAPTER_CONTROL      AtaAdapterControl;
} IDE_CONTROLLER_INTERFACE, *PIDE_CONTROLLER_INTERFACE;

Membri

Version

Il driver di porta imposta questo campo per indicare la versione del driver di porta. Il driver della porta imposta la versione su sizeof(IDE_CONTROLLER_INTERFACE). Il driver miniport deve verificare che la versione sia maggiore o uguale a quella in uso.

Reserved

Riservato per uso futuro. Il driver miniport non utilizzerà questo campo.

ControllerExtensionSize

Specifica le dimensioni in byte richieste da un driver miniport per l'estensione del dispositivo controller.

ChannelExtensionSize

Specifica le dimensioni in byte richieste da un driver miniport per l'estensione del dispositivo per canale.

AlignmentMask

Contiene una maschera che indica le restrizioni di allineamento per i buffer richiesti dall'HBA per le operazioni di trasferimento. I valori della maschera validi sono limitati anche dalle caratteristiche dei gestori di memoria in versioni diverse di Windows. In Windows 2000 e Windows XP, i valori della maschera validi sono 0 (allineati a byte), 1 (allineati a parole), 3 (allineati a DWORD) e 7 (allineati doppio DWORD). Il driver miniport deve impostare questa maschera se l'HBA supporta la raccolta/dispersione.

AtaChannelInitRoutine

Puntatore alla routine AtaChannelInitRoutine del miniport. Il miniport deve impostare questo punto di ingresso solo se supporta l'interfaccia del canale.

AtaControllerChannelEnabled

Puntatore alla routine AtaControllerChannelEnabled del miniport. Si tratta di un punto di ingresso facoltativo.

AtaControllerTransferModeSelect

Puntatore alla routine di AtaControllerTransferModeSelect del miniport. Si tratta di un punto di ingresso facoltativo.

AtaAdapterControl

Puntatore alla routine AtaControllerAdapterControl del miniport. Si tratta di un punto di ingresso obbligatorio.

Fabbisogno

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