Fungsi AtaPortRegistryChannelSubkeyWriteDeferred (irb.h)

Artikel
03/01/2024

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.

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 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)

Lihat juga

AtaPortRegistryAllocateBuffer

AtaPortRegistryFreeBuffer

Bagikan melalui