IDE_ADAPTER_CONTROL fungsi panggilan balik (irb.h)

Artikel
02/26/2024

Rutinitas driver miniport AtaAdapterControl dipanggil untuk melakukan operasi Plug and Play (PnP) dan Power Management pada HBA.

Catatan

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

Sintaks

IDE_ADAPTER_CONTROL IdeAdapterControl;

BOOLEAN IdeAdapterControl(
  [in]      PVOID ControllerExtension,
  [in]      IDE_CONTROL_ACTION ControlAction,
  [in, out] PVOID Parameters
)
{...}

Parameter

[in] ControllerExtension

Penunjuk ke ekstensi pengontrol.

[in] ControlAction

Salah satu dari lima tindakan yang harus dilakukan driver miniport seperti yang didefinisikan dalam tabel berikut.

ControlAction	Parameter	Deskripsi
IdeStart	IDE_CONTROLLER_CONFIGURATION	Menunjukkan bahwa adaptor sedang dimulai. Driver miniport harus memperbarui anggota dalam struktur IDE_CONTROLLER_CONFIGURATION . Jika diperlukan, driver miniport dapat memperoleh sumber daya perangkat kerasnya dari struktur IDE_CONTROLLER_CONFIGURATION .
IdeStop	Tidak ada	Driver miniport harus berhenti menggunakan sumber daya apa pun yang dialokasikan untuk pengontrol ini. Ketahuilah bahwa driver port menjamin bahwa semua saluran yang diekspos oleh adaptor dihentikan sebelum menghentikan adaptor.
IdePowerUp	Tidak ada	Menunjukkan bahwa adaptor sedang diaktifkan. Apa pun yang tidak bertahan di seluruh siklus daya harus dikonfigurasi selama IdePowerUp.
IdePowerDown	Tidak ada	Menunjukkan bahwa adaptor sedang dimatikan.
IdeVendorDefined	Tidak ada	Menunjukkan bahwa driver miniport harus melakukan tindakan kontrol yang ditentukan vendor.

[in, out] Parameters

Parameter yang terkait dengan tindakan yang diberikan.

Mengembalikan nilai

Driver miniport harus mengembalikan TRUE untuk mengakui penyelesaian tindakan yang diminta. Nilai pengembalian FALSE menunjukkan bahwa driver miniport tidak berhasil menyelesaikan tindakan. Nilai pengembalian FALSE untuk tindakan tertentu dapat menyebabkan penginstalan perangkat gagal.

Keterangan

Driver port menjamin bahwa tidak ada I/O yang luar biasa pada adaptor sebelum memanggil rutinitas AtaAdapterControl .

Persyaratan

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

Lihat juga

IDE_CONTROLLER_CONFIGURATION

Bagikan melalui