Fungsi StorPortRegistryWriteAdapterKey (storport.h)

Artikel
04/30/2024

Rutinitas StorPortRegistryReadAdapterKey dipanggil oleh driver miniport untuk membaca kunci adaptor registri perangkat keras atau perangkat yang terletak di registri di HKLM/CurrentControlSet/Enum/Instance path/DeviceParameters/... kunci ini dibaca dari di Bagian INF DDInstall.HW.

Sintaks

ULONG StorPortRegistryWriteAdapterKey(
  [in]           PVOID  HwDeviceExtension,
  [in, optional] PUCHAR SubKeyName,
  [in]           PUCHAR ValueName,
  [in]           ULONG  ValueType,
  [in, out]      PVOID  ValueData,
  [in, out]      ULONG  ValueDataLength
);

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. Pengandar porta membebaskan memori ini ketika melepas perangkat. Driver miniport harus berjalan di IRQL PASSIVE_LEVEL ketika memanggil rutinitas ini.

[in, optional] SubKeyName

Subkunjud miniport.

[in] ValueName

Nama Nilai di bawah kunci.

[in] ValueType

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, out] ValueData

Arahkan ke data yang berisi data registri yang akan dibaca. Data dikonversi dari UNICODE ke string ASCII yang dihentikan NULL.

[in, out] ValueDataLength

Menentukan ukuran data yang ditujukan oleh ValueData.

Menampilkan nilai

Mengembalikan STOR_STATUS_SUCCESS ketika operasi berhasil, jika tidak, kode kesalahan yang sesuai.

Persyaratan

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

Lihat juga

StorPortInitialize

Bagikan melalui