Funzione AtaPortInitializeEx (irb.h)

Articolo
02/29/2024

La routine del driver di porta AtaPortInitializeEx ATA inizializza i driver di porta e miniport.

Nota I modelli di driver di porta ATA e miniport ATA potrebbero essere modificati o non disponibili in futuro. È invece consigliabile usare il driver Storport e i modelli di driver miniport Storport .

Sintassi

ULONG AtaPortInitializeEx(
  [in] PVOID                     DriverObject,
  [in] PVOID                     RegistryPath,
  [in] PIDE_CONTROLLER_INTERFACE ControllerInterface
);

Parametri

[in] DriverObject

Puntatore all'oggetto driver miniport.

[in] RegistryPath

Contiene una stringa Unicode che indica il percorso nel Registro di sistema in cui sono archiviate le informazioni di configurazione del driver miniport.

[in] ControllerInterface

Contiene i punti di ingresso per le routine AtaAdapterControl, AtaChannelInitRoutine, AtaControllerChannelEnabled e AtaControllerTransferModeSelect .

Valore restituito

AtaPortInitializeEx restituisce STATUS_SUCCESS se l'operazione ha esito positivo. In caso contrario, restituisce un codice di errore.

Commenti

La routine AtaPortInitializeEx inizializza le strutture di dati chiave usate dai driver porta e miniport. Avvia anche l'inizializzazione dei canali del controller. La sequenza seguente descrive le azioni principali eseguite da questa routine:

Durante la routine DriverEntry , il driver miniport chiama la routine della libreria AtaPortInitializeEx del driver di porta e passa i parametri chiave seguenti:
- ControllerInterface: contiene i punti di ingresso per le routine AtaAdapterControl, AtaChannelInitRoutine, AtaControllerChannelEnabled e AtaControllerTransferModeSelect .
La routine AtaPortInitializeEx inizializza le strutture di dati chiave usate dai driver porta e miniport ed esegue le azioni seguenti:
1. Inizializza le tabelle dispatch del driver miniport.
2. Alloca un'estensione per l'oggetto driver.
3. Copia ControllerInterface nell'estensione del driver.
4. Dopo che AtaPortInitializeEx completa l'inizializzazione del driver di porta, torna alla routine DriverEntry del driver miniport.
Durante l'avvio del dispositivo adattatore, la routine del driver miniport AtaAdapterControl verrà chiamata dal driver di porta con l'azione di controllo IdeStart.
Quando il driver della porta ATA elabora una richiesta di avvio del dispositivo del canale, viene chiamata la routine del driver miniport AtaControllerChannelEnabled per ogni canale nel controller per determinare se è abilitato.
Dopo che la routine AtaControllerChannelEnabled determina quali canali sono abilitati, il driver della porta ATA chiama AtaChannelInitRoutine per questo canale.