IDE_CHANNEL_INIT fungsi panggilan balik (irb.h)

Artikel
03/01/2024

Driver miniport AtaChannelInitRoutine rutin menginisialisasi antarmuka saluran driver 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

IDE_CHANNEL_INIT IdeChannelInit;

BOOLEAN IdeChannelInit(
  PVOID ChannelExtension,
  PIDE_CHANNEL_INTERFACE ChannelInterface,
  PVOID InitContext
)
{...}

Parameter

ChannelExtension

[in] Penunjuk ke ekstensi saluran driver miniport.

ChannelInterface

[in, out] Arahkan ke struktur IDE_CHANNEL_INTERFACE yang berisi informasi antarmuka untuk saluran yang ditunjukkan.

InitContext

[in, out] Penunjuk ke ekstensi pengontrol.

Nilai kembali

AtaChannelInitRoutine mengembalikan TRUE jika inisialisasi berhasil. Ini mengembalikan FALSE jika inisialisasi gagal.

Keterangan

Driver miniport yang disediakan vendor yang mendukung antarmuka saluran harus menerapkan rutinitas AtaChannelInitRoutine untuk menginisialisasi saluran pengontrol. Secara khusus, rutinitas AtaChannelInitRoutine harus menyelesaikan inisialisasi struktur IDE_CHANNEL_INTERFACE . Urutan berikut menjelaskan bagaimana driver miniport dan driver port berinteraksi untuk menginisialisasi saluran:

Sementara dalam rutinitas DriverEntry-nya , driver miniport memanggil rutinitas pustaka AtaPortInitializeEx driver port untuk meluncurkan inisialisasi pengontrol dan driver miniport.
Jika driver miniport mendukung antarmuka saluran, rutinitas DriverEntry harus menginisialisasi anggota AtaChannelInitRoutineIDE_CONTROLLER_INTERFACE untuk menunjuk ke rutinitas AtaChannelInitRoutine driver miniport.
Driver port memanggil rutinitas AtaAdapterControl dengan menggunakan tindakan kontrol IdeStart. AtaChannelInitRoutine dipanggil satu kali untuk setiap NumberOfChannels yang ditentukan dalam struktur ControllerConfiguration yang dikembalikan oleh rutinitas AtaAdapterControl ketika AtaAdapterControl menangani tindakan IdeStart .