Fungsi AtaPortRegistryControllerKeyRead (irb.h)

Artikel
02/26/2024

Rutinitas AtaPortRegistryControllerKeyRead membaca data yang terkait dengan nama nilai yang ditunjukkan di bawah kunci HKLM\CurrentControlSet\Services\<service name>\ControllerNregistri , di mana N adalah jumlah pengontrol.

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

BOOLEAN AtaPortRegistryControllerKeyRead(
  [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 yang akan dibaca.

[in] ValueType

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

Jenis nilai	Makna
IDE_REG_DWORD	Nilai numerik 4-byte.
IDE_REG_BINARY	Data biner.
IDE_REG_SZ	String Unicode yang dihentikan null.

[out, optional] Buffer

Penunjuk ke buffer tempat hasilnya akan disalin.

BufferLength

Penunjuk ke jumlah byte data yang akan disalin. Jika operasi gagal karena buffer yang tidak mencukupi, lokasi yang diacu oleh Panjang akan diperbarui ke panjang data aktual dalam registri.

Mengembalikan nilai

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

Keterangan

Buffer di Buffer harus dialokasikan dengan menggunakan AtaPortRegistryAllocateBuffer.

Driver miniport harus memanggil AtaPortRegistryControllerKeyRead baik dalam rutinitas AtaChannelInitRoutine atau dalam rutinitas IdeHwControl-nya . Ini tidak dapat memanggil AtaPortRegistryControllerKeyRead dari rutinitas lainnya. Selain itu, driver miniport hanya dapat memanggil AtaPortRegistryControllerKeyRead 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

IdeHwControl

Bagikan melalui