Fungsi AtaPortRegistryChannelSubkeyWrite (irb.h)
Rutinitas AtaPortRegistryChannelSubKeyWrite menulis data ke nama nilai yang ditunjukkan di bawah kunci HKLM\CurrentControlSet\Services\<service name>\ControllerN\ChannelM
registri , di mana N adalah jumlah pengontrol dan M adalah jumlah saluran.
Sintaks
BOOLEAN AtaPortRegistryChannelSubkeyWrite(
[in] PVOID ChannelExtension,
[in] UCHAR ControllerNumber,
[in] PCHAR ValueName,
[in] UCHAR ValueType,
[in] PUCHAR Buffer,
PULONG BufferLength
);
Parameter
[in] ChannelExtension
Penunjuk ke ekstensi saluran.
[in] ControllerNumber
Berisi nomor pengontrol.
[in] ValueName
Berisi nama nilai registri yang akan ditulis.
[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 | String Unicode yang dihentikan null. |
[in] Buffer
Penunjuk ke buffer sumber yang berisi data yang akan ditulis ke registri.
BufferLength
Penunjuk ke jumlah byte data yang akan disalin. Jika operasi gagal, lokasi yang diacu oleh Panjang akan diperbarui ke panjang data yang berhasil ditulis ke registri.
Nilai kembali
AtaPortRegistryChannelSubKeyWrite mengembalikan TRUE jika operasi berhasil. Jika tidak, ia mengembalikan FALSE. Rutinitas juga mengembalikan FALSE jika driver miniport tidak memanggilnya dari rutinitas yang benar.
Keterangan
Jika nama nilai tidak ada, AtaPortRegistryChannelSubKeyWrite membuat entri untuk nilai dan data disimpan dalam nilai yang baru dibuat.
Buffer yang diarahkan oleh Buffer harus dialokasikan dengan menggunakan AtaPortRegistryAllocateBuffer.
Driver miniport harus memanggil AtaPortRegistryChannelSubKeyWrite baik selama rutinitas AtaChannelInitRoutine atau rutinitas IdeHwControl Driver miniport tidak dapat memanggil AtaPortRegistryChannelSubKeyWrite dari rutinitas lain tanpa mengembalikan FALSE. Selain itu, driver miniport hanya dapat memanggil AtaPortRegistryChannelSubKeyWrite dari rutinitas IdeHwControl-nya jika rutinitas IdeHwControl-nya dipanggil dan memiliki nilai baik StartChannel atau StopChannel dalam parameter ControlAction-nya .
Persyaratan
Persyaratan | Nilai |
---|---|
Target Platform | Desktop |
Header | irb.h (termasuk Ata.h, Irb.h) |
Lihat juga
AtaPortRegistryChannelSubKeyRead