Fungsi AtaPortInitializeEx (irb.h)

Artikel
08/07/2023

Pustaka driver port AtaPortInitializeEx ATA rutin menginisialisasi driver port dan miniport.

Catatan Driver port ATA dan model driver miniport ATA dapat diubah atau tidak tersedia di masa mendatang. Sebagai gantinya, sebaiknya gunakan driver Storport dan model driver miniport Storport .

Sintaks

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

Parameter

[in] DriverObject

Penunjuk ke objek driver miniport.

[in] RegistryPath

Berisi string Unicode yang menunjukkan lokasi di registri tempat informasi konfigurasi driver miniport disimpan.

[in] ControllerInterface

Berisi titik masuk untuk rutinitas AtaAdapterControl, AtaChannelInitRoutine, AtaControllerChannelEnabled, dan AtaControllerTransferModeSelect .

Nilai kembali

AtaPortInitializeEx mengembalikan STATUS_SUCCESS jika operasi berhasil. Jika tidak, kode kesalahan akan dikembalikan.

Keterangan

Rutinitas AtaPortInitializeEx menginisialisasi struktur data utama yang digunakan oleh driver port dan miniport. Ini juga memulai inisialisasi saluran pengontrol. Urutan berikut menjelaskan tindakan utama yang diambil oleh rutinitas ini:

Saat dalam rutinitas DriverEntry-nya , driver miniport memanggil rutinitas pustaka AtaPortInitializeEx driver port dan meneruskannya parameter kunci berikut:
- ControllerInterface: Berisi titik masuk untuk rutinitas AtaAdapterControl, AtaChannelInitRoutine, AtaControllerChannelEnabled, dan AtaControllerTransferModeSelect .
Rutinitas AtaPortInitializeEx menginisialisasi struktur data utama yang digunakan oleh port dan driver miniport dan melakukan tindakan berikut:
1. Menginisialisasi tabel pengiriman driver miniport.
2. Mengalokasikan ekstensi untuk objek pengandar.
3. Menyalin ControllerInterface ke ekstensi driver.
4. Setelah AtaPortInitializeEx menyelesaikan inisialisasi driver port, ia kembali ke rutinitas DriverEntry driver miniport.
Saat memulai perangkat adaptor, rutinitas driver miniport AtaAdapterControl akan dipanggil oleh driver port dengan tindakan kontrol IdeStart.
Ketika driver port ATA memproses permintaan mulai perangkat saluran, rutinitas driver miniport AtaControllerChannelEnabled dipanggil untuk setiap saluran pada pengontrol untuk menentukan apakah itu diaktifkan.
Setelah rutinitas AtaControllerChannelEnabled menentukan saluran mana yang diaktifkan, driver port ATA memanggil AtaChannelInitRoutine untuk saluran ini.