Funzione StorPortInitialize (storport.h)

  • Articolo

La routine StorPortInitialize inizializza i parametri del driver di porta e i dati dell'estensione. StorPortInitialize salva anche le informazioni sull'adattatore fornite dalla routine driver miniportDriverEntry .

Sintassi

STORPORT_API ULONG StorPortInitialize(
  [in]           PVOID                   Argument1,
  [in]           PVOID                   Argument2,
  [in]           _HW_INITIALIZATION_DATA *HwInitializationData,
  [in, optional] PVOID                   HwContext
);

Parametri

[in] Argument1

Primo puntatore con cui il sistema operativo ha chiamato la routine DriverEntry del miniport.

[in] Argument2

Secondo puntatore con cui il sistema operativo ha chiamato la routine DriverEntry del miniports.

[in] HwInitializationData

Puntatore alle informazioni di inizializzazione e configurazione impostate dal driver miniport nella routine DriverEntry.

[in, optional] HwContext

Indirizzo di un valore di contesto da passare alla routine HwStorFindAdapter 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 HwStorFindAdapter.

Valore restituito

Risultato delle azioni di inizializzazione eseguite da StorPortInitialize. Il driver miniport restituirà questo valore come valore restituito per la routine DriverEntry.

StorPortInitialize restituisce uno dei codici di stato seguenti:

Codice restituito Descrizione
STATUS_INVALID_PARAMETER Argument1 è NULL o Argument2 è NULL, OR HwInitializationData è NULL.
STATUS_SUCCESS I dati dell'estensione del driver e le informazioni sull'adattatore sono stati inizializzati correttamente.
STATUS_NO_MEMORY Nessuna memoria è disponibile per archiviare un parametro di inizializzazione.
STATUS_REVISION_MISMATCH La versione della struttura a cui fa riferimento HwInitializationData non è valida per il sistema operativo corrente.
STATUS_INSUFFICENT_RESOURCES L'allocazione non è riuscita per i dati dell'estensione dell'oggetto driver.

Commenti

Questa routine deve essere chiamata dalla routine driver del miniportEntry .

Poiché i driver miniport Storport devono supportare PnP, il driver Storport non usa il parametro HwContext passato a StorPortInitialize.

Ogni routine driver DriverEntry di ogni miniport deve chiamare StorPortInitialize dopo che il driver miniport ha prima zero e quindi impostare i membri di HW_INITIALIZATION_DATA.

Requisiti

Requisito Valore
Piattaforma di destinazione Universale
Intestazione Storport.h (include Storport.h)
Libreria Storport.lib

Vedi anche

HW_INITIALIZATION_DATA

HwStorFindAdapter