Fungsi AtaPortRegistryChannelSubkeyRead (irb.h)

Artikel
02/29/2024

Rutinitas AtaPortRegistryChannelSubKeyRead membaca data yang terkait dengan nama nilai yang ditunjukkan di bawah kunci HKLM\CurrentControlSet\Services\<service name>\ControllerN\ChannelMregistri , di mana N adalah jumlah pengontrol dan M adalah jumlah saluran.

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

BOOLEAN AtaPortRegistryChannelSubkeyRead(
  [in]            PVOID  ChannelExtension,
  [in]            UCHAR  ControllerNumber,
  [in]            PCHAR  ValueName,
  [in]            UCHAR  ValueType,
  [out, optional] PUCHAR Buffer,
                  PULONG BufferLength
);

Parameter

[in] ChannelExtension

Penunjuk ke ekstensi saluran.

[in] ControllerNumber

Berisi nomor pengontrol.

[in] ValueName

Berisi nama nilai registri untuk dibaca.

[in] ValueType

Menunjukkan jenis data yang terkandung dalam nilai registri. Anggota ini harus diberi salah satu nilai yang ditunjukkan dalam tabel berikut.

Nilai	Makna
IDE_REG_DWORD	Nilai numerik 4-byte.
IDE_REG_BINARY	Data biner.
IDE_REG_SZ	Dihentikan null. Untai (karakter) Unicode.

[out, optional] Buffer

Penunjuk ke buffer tujuan tempat data yang dibaca dari registri akan ditulis.

BufferLength

Penunjuk ke jumlah byte data yang akan disalin. Jika operasi gagal, lokasi yang diacu oleh Panjang akan diperbarui ke panjang data yang berhasil disalin dari registri.

Mengembalikan nilai

AtaPortRegistryChannelSubKeyRead mengembalikan TRUE jika operasi berhasil. Jika tidak, ia mengembalikan FALSE. Rutinitas juga mengembalikan FALSE jika driver miniport tidak memanggilnya dari rutinitas yang benar.

Keterangan

Buffer yang diarahkan oleh Buffer harus dialokasikan dengan menggunakan AtaPortRegistryAllocateBuffer.

Driver miniport harus memanggil AtaPortRegistryChannelSubKeyRead baik selama rutinitas AtaChannelInitRoutine atau rutinitas IdeHwControl atau akan mengembalikan FALSE. Selain itu, driver miniport hanya dapat memanggil AtaPortRegistryChannelSubKeyRead dari rutinitas IdeHwControl-nya jika rutinitas IdeHwControl-nya dipanggil dan memiliki nilai StartChannel atau StopChannel dalam parameter ControlAction-nya .

Persyaratan

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

Lihat juga

AtaChannelInitRoutine

AtaPortRegistryAllocateBuffer

AtaPortRegistryChannelSubKeyWrite

IdeHwControl

Bagikan melalui