Funzione AtaPortInitializeEx (irb.h)

Articolo
02/07/2025

La routine AtaPortInitializeEx libreria di driver delle porte ATA inizializza i driver 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 driver Storport e 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 il AtaAdapterControl, AtaChannelInitRoutine, AtaControllerChannelEnablede Routine AtaControllerTransferModeSelect.

Valore restituito

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

Osservazioni

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:

Mentre nella routine DriverEntry, il driver miniport chiama la routine di ataPortInitializeEx del driver di porta e passa i parametri chiave seguenti:
- ControllerInterface: contiene i punti di ingresso per AtaAdapterControl, AtaChannelInitRoutine, AtaControllerChannelEnablede 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 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 della porta con azione di controllo IdeStart.
Quando il driver di 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 di AtaControllerChannelEnabled determina quali canali sono abilitati, il driver della porta ATA chiama AtaChannelInitRoutine per questo canale.