IDE_CHANNEL_INIT fungsi panggilan balik (irb.h)
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 .
Persyaratan
Persyaratan | Nilai |
---|---|
Target Platform | Desktop |
Header | irb.h (termasuk Irb.h) |