IDE_CONTROLLER_INTERFACE struttura (irb.h)

  • Articolo

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

Nota I modelli di driver di porta ATA e ATA miniport possono essere modificati o non disponibili in futuro. È invece consigliabile usare i modelli di driver Storport e 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;

Members

Version

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

Reserved

Riservato per utilizzi futuri. Il driver miniport non userà 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 parole) e 7 (doppia DWORD allineata). Il driver miniport deve impostare questa maschera se l'HBA supporta la dispersione/raccolta.

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 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.

Requisiti

Requisito Valore
Intestazione irb.h (includere Irb.h)