Fungsi StorPortRegistryWrite (storport.h)

  • Artikel

Rutinitas StorPortRegistryWrite dipanggil oleh driver miniport untuk mengonversi data registri yang terkandung dalam buffer tertentu dari ASCII ke Unicode dan kemudian menulis data ke area penyimpanan per-HBA driver miniport.

Sintaks

STORPORT_API BOOLEAN StorPortRegistryWrite(
  [in] PVOID  HwDeviceExtension,
  [in] PUCHAR ValueName,
  [in] ULONG  Global,
  [in] ULONG  Type,
  [in] PUCHAR Buffer,
  [in] ULONG  BufferLength
);

Parameter

[in] HwDeviceExtension

Penunjuk ke ekstensi perangkat keras. Ini adalah area penyimpanan per HBA yang dialokasikan dan diinisialisasi driver port atas nama driver miniport. Driver miniport biasanya menyimpan informasi khusus HBA dalam ekstensi ini, seperti status HBA dan rentang akses yang dipetakan untuk HBA. Area ini tersedia untuk driver miniport segera setelah driver miniport memanggil StorPortInitialize. Driver port membebaskan memori ini ketika melepas perangkat. Driver miniport harus berjalan di IRQL PASSIVE_LEVEL ketika memanggil rutinitas ini.

[in] ValueName

Penunjuk ke string yang menentukan nama nilai.

[in] Global

Menunjukkan apakah operasi akan menjadi adaptor tertentu atau berhubungan dengan semua adaptor.

[in] Type

Salah satu jenis data registri berikut.

Jenis Makna
REG_SZ Untai (karakter) unicode null-terminated.
REG_EXPAND_SZ Untai (karakter) unicode null-terminated dengan referensi variabel lingkungan.
REG_BINARY Data biner.
REG_DWORD Kata ganda 32-bit.
REG_DWORD_LITTLE_ENDIAN Kata ganda 32-bit dengan format little-endian.
REG_DWORD_BIG_ENDIAN Kata ganda 32-bit dengan format big-endian.
REG_LINK Untai (karakter) Unicode yang menentukan tautan simbolis.
REG_MULTI_SZ Beberapa string Unicode.
REG_RESOURCE_LIST Daftar sumber daya di peta sumber daya.
REG_FULL_RESOURCE_DESCRIPTOR Daftar sumber daya dalam deskripsi perangkat keras.
REG_RESOURCE_REQUIREMENTS_LIST Daftar persyaratan sumber daya.
REG_QWORD Nomor quadlet 64-bit.
REG_QWORD_LITTLE_ENDIAN Nomor quadlet 64-bit dengan format little-endian.

[in] Buffer

Penunjuk ke buffer yang berisi data registri yang akan ditulis.

[in] BufferLength

Menentukan ukuran buffer yang diacu oleh Buffer.

Mengembalikan nilai

StorPortRegistryWrite mengembalikan nilai Boolean TRUE jika data registri berhasil dikonversi dan ditulis; jika tidak, rutinitas ini mengembalikan FALSE.

Persyaratan

Persyaratan Nilai
Target Platform Universal
Header storport.h (termasuk Storport.h)
Pustaka Storport.lib
IRQL PASSIVE_LEVEL
Aturan kepatuhan DDI StorPortIrql(storport)

Lihat juga

StorPortInitialize