Fungsi StorPortRegistryWrite (storport.h)
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) |