Fungsi StorPortRegistryReadAdapterKey (storport.h)

  • Artikel

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 StorPortRegistryReadAdapterKey(
  [in]           PVOID  HwDeviceExtension,
  [in, optional] PUCHAR SubKeyName,
  [in]           PUCHAR ValueName,
  [in]           ULONG  ValueType,
  [in, out]      PVOID  *ValueData,
  [in, out]      PULONG 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. Driver port membebaskan memori ini ketika melepas perangkat. Driver miniport harus berjalan di IRQL PASSIVE_LEVEL ketika memanggil rutinitas ini.

[in, optional] SubKeyName

Kunci 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 ditujukkan 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