Fungsi AtaPortRegistryControllerKeyWrite (irb.h)
Rutinitas AtaPortRegistryControllerKeyWrite menulis data ke nama nilai yang ditunjukkan di bawah kunci HKLM\CurrentControlSet\Services\<service name>\ControllerN
registri , di mana N adalah jumlah pengontrol.
Sintaks
BOOLEAN AtaPortRegistryControllerKeyWrite(
[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 untuk 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 untuk ditulis ke nilai registri.
BufferLength
Penunjuk ke jumlah byte data yang akan disalin. Jika operasi gagal, lokasi yang diacu oleh Panjang akan memperbarui panjang data yang berhasil disalin ke registri.
Nilai kembali
AtaPortRegistryControllerKeyWrite 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 harus dialokasikan dengan menggunakan AtaPortRegistryAllocateBuffer.
Driver miniport harus memanggil AtaPortRegistryControllerKeyWrite selama rutinitas AtaChannelInitRoutine atau rutinitas IdeHwControl .; Driver miniport tidak dapat memanggil AtaPortRegistryControllerKeyWrite dari rutinitas lain atau akan mengembalikan FALSE. Selain itu, driver miniport hanya dapat memanggil AtaPortRegistryControllerKeyWrite 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) |