IDE_HW_INITIALIZE fungsi panggilan balik (irb.h)

Artikel
02/26/2024

IdeHwInitialize miniport driver rutin mengonfigurasi perangkat yang ditunjukkan.

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_HW_INITIALIZE IdeHwInitialize;

BOOLEAN IdeHwInitialize(
  [in]      PVOID ChannelExtension,
  [in, out] PIDE_DEVICE_PARAMETERS DeviceParameters,
  [in]      PIDENTIFY_DEVICE_DATA IdentifyData
)
{...}

Parameter

[in] ChannelExtension

Penunjuk ke driver miniport per ekstensi perangkat saluran.

[in, out] DeviceParameters

Penunjuk ke struktur jenis IDE_DEVICE_PARAMETERS yang mengidentifikasi perangkat untuk dikonfigurasi dan parameter perangkat untuk mengonfigurasi perangkat.

[in] IdentifyData

Penunjuk ke struktur jenis IDENTIFY_DEVICE_DATA yang berisi data identifikasi yang dikembalikan oleh perangkat.

Nilai kembali

IdeHwInitialize mengembalikan TRUE jika operasi berhasil. Ini mengembalikan FALSE jika operasi gagal.

Keterangan

Setelah driver miniport menghitung perangkat pada saluran, ia memanggil IdeHwInitialize rutin satu kali untuk setiap perangkat yang dijumlahkan. Rutinitas IdeHwInitialize harus mengonfigurasi setiap perangkat berdasarkan informasi yang ditentukan dalam struktur IDE_DEVICE_PARAMETERS , yang diarahkan oleh parameter DeviceParameters . Dalam kasus luar biasa, driver miniport dapat mengonfigurasi perangkat dengan menggunakan sekumpulan parameter yang berbeda dari yang terkandung dalam IDE_DEVICE_PARAMETERS. Dalam kasus seperti itu, driver miniport harus memperbarui informasi dalam IDE_DEVICE_PARAMETERS untuk berisi nilai parameter yang benar-benar digunakan untuk mengonfigurasi perangkat. Setelah IdeHwInitialize rutin kembali, driver port memperbarui informasi cache-nya dengan nilai parameter yang disediakan oleh driver miniport.

Persyaratan

Persyaratan	Nilai
Target Platform	Desktop
Header	irb.h (termasuk Irb.h)

Lihat juga

IDENTIFY_DEVICE_DATA

IDE_DEVICE_PARAMETERS

Bagikan melalui