Funzione StorPortInitialize (storport.h)

Articolo
07/16/2024

La routine StorPortInitialize inizializza i parametri del driver della porta e i dati dell'estensione. StorPortInitialize salva anche le informazioni sull'adattatore fornite dal driver miniportroutine DriverEntry.

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

[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 di del driver miniport HwStorFindAdapter routine. Solo i driver miniport legacy che eseguano la scansione del bus per individuare hbA anziché ricevere informazioni di configurazione dal driver di porta possono usare questo parametro per archiviare lo stato tra le 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 oppure Argument2 è NULL oppure HwInitializationData è NULL.
STATUS_SUCCESS	Le informazioni sull'estensione del driver e sull'adattatore sono state inizializzate correttamente.
STATUS_NO_MEMORY	Non è disponibile memoria per archiviare un parametro di inizializzazione.
STATUS_REVISION_MISMATCH	La versione della struttura a cui punta HwInitializationData non è valida per il sistema operativo corrente.
STATUS_INSUFFICENT_RESOURCES	Allocazione non riuscita per i dati dell'estensione dell'oggetto driver.

Osservazioni

Questa routine deve essere chiamata dalla routine DriverEntry del driver miniport.

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

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

Fabbisogno

Requisito	Valore
piattaforma di destinazione	Universale
intestazione	storport.h (include Storport.h)
libreria	Storport.lib

Vedere anche

HW_INITIALIZATION_DATA

HwStorFindAdapter

Condividi tramite