Funzione SCSIPortInitialize (srb.h)

Articolo
02/27/2024

Per un driver miniport non Plug and Play, la routine SCSIPortInitialize configura la struttura PORT_CONFIGURATION_INFORMATION e chiama la routine HwScsiFindAdapter del driver miniport. SCSIPortInitialize configura anche oggetti di sistema e risorse per conto dei driver miniport. Per un driver miniport Plug and Play, SCSIPortInitialize archivia i dati di inizializzazione del driver miniport per un uso futuro.

Nota I modelli di driver di porta SCSI e miniport SCSI possono essere modificati o non disponibili in futuro. È invece consigliabile usare i modelli di driver Storport e Miniport Storport.

Sintassi

SCSIPORT_API ULONG ScsiPortInitialize(
  [in] PVOID                   Argument1,
  [in] PVOID                   Argument2,
  [in] _HW_INITIALIZATION_DATA *HwInitializationData,
  [in] PVOID                   HwContext
);

Parametri

[in] Argument1

Puntatore all'oggetto driver passato al driver passato al driver miniport nel primo argomento della routine DriverEntry .

[in] Argument2

Puntatore a alcune informazioni di contesto passate al driver miniport nel secondo argomento del driver DriverEntry.

[in] HwInitializationData

Puntatore alle informazioni di inizializzazione e configurazione fornite da DriverEntry.

[in] HwContext

Specifica l'indirizzo di un valore di contesto da passare alla routine HwScsiFindAdapter del driver miniport. Solo i driver miniport legacy che analizzano il bus per HBA anziché ricevere informazioni di configurazione dal driver di porta possono usare questo parametro per archiviare lo stato tra chiamate a HwScsiFindAdapter.

Valore restituito

SCSIPortInitialize restituisce un valore di stato usato come valore restituito dalla routine DriverEntry del driver miniport.

Commenti

Ogni routine driver DriverEntry di ogni miniport deve chiamare SCSIPortInitialize dopo che il driver miniport ha prima zero e quindi configurare la HW_INITIALIZATION_DATA.

Se un driver miniport può supportare HBA su diversi tipi di autobus di I/O, ad esempio i bus I/O di tipo Isa e MicroChannel , il driver miniport deve chiamare SCSIPortInitialize per ogni tipo di interfaccia supportato.

Un driver miniport che chiama SCSIPortInitialize più volte deve controllare il valore restituito da SCSIPortInitialize in ogni chiamata e salvare il valore più basso per tutte le chiamate. La routine DriverEntry deve restituire il valore più basso quando restituisce il controllo al sistema. I writer di driver miniport non possono fare ipotesi sui valori restituiti da SCSIPortInitialize.

Requisiti

Requisito	Valore
Piattaforma di destinazione	Desktop
Intestazione	srb.h (include Miniport.h, SCSI.h)
Libreria	Scsiport.lib

Vedi anche

DriverEntry del driver miniport SCSI

HW_INITIALIZATION_DATA (SCSI)

HwScsiFindAdapter

Condividi tramite