Fungsi AtaPortRegistryChannelSubkeyWriteDeferred (irb.h)
Rutinitas AtaPortRegistryChannelSubKeyWriteDeferred menulis data secara asinkron ke 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.
Sintaks
BOOLEAN AtaPortRegistryChannelSubkeyWriteDeferred(
[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 | Dihentikan null. Untai (karakter) Unicode. |
[in] Buffer
Arahkan 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.
Mengembalikan nilai
AtaPortRegistryChannelSubKeyWriteDeferred mengembalikan TRUE jika operasi. Jika tidak, ia mengembalikan FALSE. Rutinitas juga mengembalikan FALSE jika driver miniport tidak memanggilnya dari rutinitas yang benar.
Keterangan
Jika nama nilai tidak ada, AtaPortRegistryChannelSubKeyWriteDeferred membuat entri untuk nilai dan data disimpan dalam nilai yang baru dibuat.
Buffer yang diarahkan oleh Buffer harus dialokasikan dengan menggunakan AtaPortRegistryAllocateBuffer.
Driver miniport dapat memanggil AtaPortRegistryChannelSubKeyWriteDeferred dari salah satu rutinitas utama yang termasuk dalam antarmuka salurannya.
Driver miniport tidak boleh menggunakan kembali buffer yang diarahkan oleh Buffer setelah panggilan awal ke AtaPortRegistryChannelSubKeyWriteDeferred. Karena panggilan tidak sinkron, Buffer mungkin masih menunjuk ke data yang belum dihapus ke registri. Driver port menghapus data di buffer ke registri ketika driver miniport memanggil AtaPortRegistryFreeBuffer.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Target Platform | Desktop |
| Header | irb.h (termasuk Ata.h, Irb.h) |